Merge remote-tracking branch 'upstream/develop' into 4.6

user_guide_src/source/cli/cli_request.rst

@@ -31,7 +31,7 @@ Returns an array of the command line arguments deemed to be options:
 
 .. literalinclude:: cli_request/003.php
 
-getOption($which)
+getOption($key)
 -----------------
 
 Returns the value of a specific command line argument deemed to be an option:

user_guide_src/source/concepts/goals.rst

@@ -0,0 +1,32 @@
+##############################
+Design and Architectural Goals
+##############################
+
+Our goal for CodeIgniter is maximum performance, capability, and
+flexibility in the smallest, lightest possible package.
+
+To meet this goal we are committed to benchmarking, re-factoring, and
+simplifying at every step of the development process, rejecting anything
+that doesn't further the stated objective.
+
+From a technical and architectural standpoint, CodeIgniter was created
+with the following objectives:
+
+-  **Dynamic Instantiation.** In CodeIgniter, components are loaded and
+   routines executed only when requested, rather than globally. No
+   assumptions are made by the system regarding what may be needed
+   beyond the minimal core resources, so the system is very light-weight
+   by default. The events, as triggered by the HTTP request, and the
+   controllers and views you design will determine what is invoked.
+-  **Loose Coupling.** Coupling is the degree to which components of a
+   system rely on each other. The less components depend on each other
+   the more reusable and flexible the system becomes. Our goal was a
+   very loosely coupled system.
+-  **Component Singularity.** Singularity is the degree to which
+   components have a narrowly focused purpose. In CodeIgniter, each
+   class and its functions are highly autonomous in order to allow
+   maximum usefulness.
+
+CodeIgniter is a dynamically instantiated, loosely coupled system with
+high component singularity. It strives for simplicity, flexibility, and
+high performance in a small footprint package.

user_guide_src/source/concepts/index.rst

@@ -14,3 +14,4 @@ The following pages describe the architectural concepts behind CodeIgniter4:
     factories
     http
     security
+    goals

user_guide_src/source/extending/core_classes.rst

@@ -86,7 +86,7 @@ Then you would add the ``routes`` service in **app/Config/Services.php** to load
 Extending Core Classes
 ======================
 
-If all you need to is add some functionality to an existing library - perhaps add a method or two - then it's overkill
+If all you need is to add some functionality to an existing library - perhaps add a method or two - then it's overkill
 to recreate the entire library. In this case, it's better to simply extend the class. Extending the class is nearly
 identical to `Replacing Core Classes`_ with one exception: