Help Needed with Documentation

Can I help?

On the folder stucture, the downloaded installation does not have the tests directory either.

However, on the Extending the Controllers questions, there are 2 ways of doing it. Either extending the CodeIgniter System Controller Directly or more preferably extending the BaseController in you app folder. 

This part is documented in : https://codeigniter.com/user_guide/exten...controller

However, a reference to this section can be added into the First Application for clarity.

[quote pid="387342" dateline="1622815646"]
I'm interested.
[/quote]

Interface help comes in two forms: proactive and reactive. Proactive help is intended to get users familiar with an interface while reactive help is meant for troubleshooting and gaining system proficiency.

Why are you spamming this forum? You said you wanted to help with documentation. Then just to it. Don't post your philosophic theories on why documentation is important.

CodeIgniter 4 tutorials (EN/FR) - https://includebeer.com
/*** NO support in private message - Use the forum! ***/

My question was: is the online documentation up to date, or out of date? As a complete newbie I notice the documentation says "A fresh install has six directories: /app, /system, /public, /writable, /tests and possibly /docs." But my fresh installation (via Scriptaculous) is different. It has these top-level directories: /app, /public, /tests, /vendor, /writable This makes me think the documenation is not up to date, which is of some concern as I will have to rely on docs (and forum).

Thank you!

I sent a PR to fix it.
https://github.com/codeigniter4/CodeIgniter4/pull/5347

---

Also, the "First Application" tutorial Pages.php has this:

Code:

namespace App\Controllers;
use CodeIgniter\Controller;
class Pages extends Controller

which differs from the fresh installation Home.php which has this:

Code:

namespace App\Controllers;
class Home extends BaseController

Should I be concerned by these differences? Are they deliberate or do they represent out of date documentation?

I sent a PR to fix it.
https://github.com/codeigniter4/CodeIgniter4/pull/5348

Using BaseController is recommended. Because if you want to add something to all your controller later,
you could do it with BaseController.

But if you don't use BaseController, extend Controller, your controller is completely fine.

ci-phpunit-test | CodeIgniter Testing Guide | CodeIgniter 3 to 4 Upgrade Helper

On the folder stucture, the downloaded installation does not have the tests directory either.

Thank you. It must be a bug.

I sent a PR to fix it.
https://github.com/codeigniter4/CodeIgniter4/pull/5350

---

Hi all.

When you send Pull Requests (PRs), you might fix the User Guide very quickly like the following.

The current in-progress User Guide

• https://codeigniter4.github.io/CodeIgnit...irectories
  
• https://codeigniter4.github.io/CodeIgnit...controller
  

The fixes will be included the next release.

See https://github.com/codeigniter4/CodeIgni.../README.md

I recommend you send a very small PR first, not a very big one.

ci-phpunit-test | CodeIgniter Testing Guide | CodeIgniter 3 to 4 Upgrade Helper

We need your help.

There are many PRs to improve the documentation.
But it seems there are no reviewers at the moment.
https://github.com/codeigniter4/CodeIgni...dated-desc

If someone has time, please review and approve the PRs if it is okay!

ci-phpunit-test | CodeIgniter Testing Guide | CodeIgniter 3 to 4 Upgrade Helper