Fix remaining docs issues: grammar, typos, broken content, and RST artifacts. (#8205)

Author: dereuromark

docs/en/appendices/5-2-migration-guide.md

@@ -45,7 +45,7 @@ bin/cake upgrade rector --rules cakephp52 <path/to/app/src>
 ### Event
 
 - Returning values from event listeners / callbacks is deprecated. Use `$event->setResult()`
-  instead or `$event->stopPropogation()` to just stop the event propogation.
+  instead or `$event->stopPropagation()` to just stop the event propagation.
 
 ### View
 

docs/en/appendices/5-3-migration-guide.md

@@ -41,7 +41,7 @@ If you are not running on **PHP 8.2 or higher**, you will need to upgrade PHP be
 
 ### Validation
 
-- The signature of `Validator::validate(array $data, bool $newRecord = true, array $context = [])` has now a additional third parameter `$context`.
+- The signature of `Validator::validate(array $data, bool $newRecord = true, array $context = [])` now has an additional third parameter `$context`.
   It can be used to pass necessary context into the validation when marshalling.
 
 ### View

docs/en/console-commands.md

@@ -141,7 +141,7 @@ command. Then learn more about commands:
 ## Routing in the Console Environment
 
 In command-line interface (CLI), specifically your console commands,
-`env('HTTP_HOST')` and other webbrowser specific environment variables are not
+`env('HTTP_HOST')` and other web browser specific environment variables are not
 set.
 
 If you generate reports or send emails that make use of `Router::url()` those

docs/en/contributing/code.md

@@ -126,8 +126,8 @@ branch, as you cannot edit it once the pull request is created.
   should choose the branch with the next version number. For example if the
   current stable release is `4.0.0`, the branch accepting new features will
   be `4.next`.
-- If your change is a breaks existing functionality, or APIs then you'll have
-  to choose then next major release. For example, if the current release is
+- If your change breaks existing functionality, or APIs then you'll have
+  to choose the next major release. For example, if the current release is
   `4.0.0` then the next time existing behavior can be broken will be in
   `5.x` so you should target that branch.
 

docs/en/contributing/documentation.md

@@ -512,7 +512,7 @@ npx markdownlint-cli --config .github/markdownlint.json "docs/en/**/*.md"
 
 ```bash [Auto-fix]
 # Automatically fix formatting issues
-npx markdownlint-cli --config .github/markdownlint.json --fix cs/en/**/*.md"
+npx markdownlint-cli --config .github/markdownlint.json --fix "docs/en/**/*.md"
 ```
 
 :::
@@ -599,11 +599,7 @@ npx cspell --config .github/cspell.json docs/en/your-file.md
 node bin/check-links.js docs/en/your-file.md
 ```
 
-:::e --check config.js
-jq empty toc_en.json
-
-```shell
 :::
-```
+:::
 
 If the CI checks fail, review the error messages and fix the issues before requesting a review.

docs/en/controllers/components.md

@@ -135,7 +135,7 @@ class PostsController extends AppController
 
     public function delete()
     {
-        if ($this->Post->delete($this->request->getData('Post.id')) {
+        if ($this->Post->delete($this->request->getData('Post.id'))) {
             $this->Flash->success('Post deleted.');
 
             return $this->redirect(['action' => 'index']);
@@ -346,7 +346,7 @@ use Cake\Routing\Router;
 
 public function beforeFilter(EventInterface $event): void
 {
-    throw new RedirectException(Router::url('/'))
+    throw new RedirectException(Router::url('/'));
 }
 ```
 

docs/en/controllers/middleware.md

@@ -257,7 +257,7 @@ public function middleware(MiddlewareQueue $middlewareQueue): MiddlewareQueue
 If your application has cookies that contain data you want to obfuscate and
 protect against user tampering, you can use CakePHP's encrypted cookie
 middleware to transparently encrypt and decrypt cookie data via middleware.
-Cookie data is encrypted with via OpenSSL using AES:
+Cookie data is encrypted via OpenSSL using AES:
 
 ``` php
 use Cake\Http\Middleware\EncryptedCookieMiddleware;

docs/en/core-libraries/email.md

@@ -304,7 +304,7 @@ you want the filenames to appear in the recipient's mail client:
 
 You can also add attachments using the `addAttachment()` method.
 
-> \$mailer-\>addAttachment('/full/file/path/file.png');
+> `$mailer->addAttachment('/full/file/path/file.png');`
 
 ### Relaxing Address Validation Rules
 
@@ -398,7 +398,7 @@ class UsersController extends AppController
     {
         $user = $this->Users->newEmptyEntity();
         if ($this->request->is('post')) {
-            $user = $this->Users->patchEntity($user, $this->request->getData())
+            $user = $this->Users->patchEntity($user, $this->request->getData());
             if ($this->Users->save($user)) {
                 $this->getMailer('User')->send('welcome', [$user]);
             }

docs/en/core-libraries/registry-objects.md

@@ -9,7 +9,7 @@ for Helpers, Behaviors, and Tasks in addition to Components.
 
 ## Loading Objects
 
-Objects can be loaded on-the-fly using add\<registry-object\>()
+Objects can be loaded on-the-fly using `add<registry-object>()`
 Example:
 
 ``` php

docs/en/core-libraries/text.md

@@ -287,8 +287,8 @@ echo Text::highlight(
 
 Output:
 
-> Highlights \$phrase in \$text \<span class="highlight"\>using\</span\> the
-> \$options\['format'\] string specified or a default string.
+> Highlights `$phrase` in `$text` `<span class="highlight">using</span>` the
+> `$options['format']` string specified or a default string.
 
 ## Truncating Text