minor cleanup (#8169)

Author: LordSimal

README.md

@@ -2,7 +2,7 @@ CakePHP Documentation
 =====================
 
 [![License: CC BY-NC-SA 4.0](https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgreen.svg)](https://creativecommons.org/licenses/by-nc-sa/4.0/)
-[![Build Status](https://github.com/cakephp/docs/actions/workflows/ci.yml/badge.svg?branch=5.x)](https://github.com/cakephp/docs/actions/workflows/ci.yml)
+[![Build Status](https://github.com/cakephp/docs/actions/workflows/deploy_5.yml/badge.svg?branch=5.x)](https://github.com/cakephp/docs/actions/workflows/deploy_5.yml)
 
 This is the official documentation for the CakePHP project. It is available
 online at https://book.cakephp.org.

docs/en/installation.md

@@ -122,7 +122,7 @@ If you want to configure a new project, you just need:
 
 If you have an existing project:
 
-``` text
+``` shell
 git clone <your-cakephp-repo>
 cd <your-cakephp-project>
 ddev config --project-type=cakephp --docroot=webroot

docs/en/intro.md

@@ -120,8 +120,8 @@ we prepared with `set()`.
 Now that you are familiar with the different layers in CakePHP, lets review how
 a request cycle works in CakePHP:
 
-<figure class="align-center">
-<img src="/typical-cake-request.png" alt="Flow diagram showing a typical CakePHP request" />
+<figure>
+<img src="/typical-cake-request.png" alt="Flow diagram showing a typical CakePHP request" style="margin: 0 auto" />
 </figure>
 
 The typical CakePHP request cycle starts with a user requesting a page or

docs/en/intro/cakephp-folder-structure.md

@@ -3,69 +3,68 @@
 After you've downloaded the CakePHP application skeleton, there are a few top
 level folders you should see:
 
-- The *bin* folder holds the Cake console executables.
+- `bin` holds the Cake console executables so you can execute e.g. `bin/cake bake all`.
 
-- The *config* folder holds the [Configuration](../development/configuration) files
-  CakePHP uses. Database connection details, bootstrapping, core configuration files
+- `config` holds the [Configuration](../development/configuration) files.
+  Database connection details, bootstrapping, core configuration files
   and more should be stored here.
 
-- The *plugins* folder is where the [Plugins](../plugins) your application uses are stored.
+- `plugins` is where the [Plugins](../plugins) your application uses are stored.
 
-- The *logs* folder normally contains your log files, depending on your log
-  configuration.
+- `logs` contains your log files, can be adjusted via [Log Configuration](../core-libraries/logging.md#logging-configuration).
 
-- The *src* folder will be where your application’s source files will be placed.
+- `src` will be where your application’s source files like Controllers, Models, Commands etc. will be placed.
 
-- The *templates* folder has presentational files placed here:
+- `templates` has presentational files placed here:
   elements, error pages, layouts, and view template files.
 
-- The *resources* folder has sub folder for various types of resource files.
-  The *locales* sub folder stores language files for internationalization.
+- `resources` is primarily used for the `locales` sub folder storing language files for static internationalization.
 
-- The *tests* folder will be where you put the test cases for your application.
+- `tests` will be where you put the test cases for your application.
 
-- The *tmp* folder is where CakePHP stores temporary data. The actual data it
+- `tmp` is where CakePHP stores temporary data. The actual data it
   stores depends on how you have CakePHP configured, but this folder
   is usually used to store translation messages, model descriptions and sometimes
   session information.
 
-- The *vendor* folder is where CakePHP and other application dependencies will
-  be installed by [Composer](https://getcomposer.org). Editing these files is not
-  advised, as Composer will overwrite your changes next time you update.
+- `vendor` is where CakePHP and other application dependencies will
+  be installed by [Composer](https://getcomposer.org). **Editing these files is not
+  advised, as Composer will overwrite your changes next time you update.**
 
-- The *webroot* directory is the public document root of your application. It
+- `webroot` is the public document root of your application. It
   contains all the files you want to be publicly reachable.
 
-  Make sure that the *tmp* and *logs* folders exist and are writable,
-  otherwise the performance of your application will be severely
-  impacted. In debug mode, CakePHP will warn you, if these directories are not
-  writable.
+Make sure that the `tmp` and `logs` folders exist and are writable,
+otherwise the performance of your application will be severely
+impacted. In debug mode, CakePHP will warn you, if these directories are not
+writable.
 
 ## The src Folder
 
-CakePHP's *src* folder is where you will do most of your application
+CakePHP's `src` folder is where you will do most of your application
 development. Let's look a little closer at the folders inside
-*src*.
+`src`.
 
-Command  
+### Command
 Contains your application's console commands. See
 [Command Objects](../console-commands/commands) to learn more.
 
-Console  
+> [!NOTE]
+> The folder `Command` is not present by default.
+> It will be auto generated when you create your first command using bake.
+
+### Console
 Contains the installation script executed by Composer.
 
-Controller  
+### Controller
 Contains your application's [Controllers](../controllers) and their components.
 
-Middleware  
+### Middleware
 Stores any [Middleware](../controllers/middleware) for your application.
 
-Model  
-Contains your application's tables, entities and behaviors.
+### Model
+Contains your application's [Tables](../orm/table-objects.md), [Entities](../orm/entities.md) and [Behaviors](../orm/behaviors.md).
 
-View  
-Presentational classes are placed here: views, cells, helpers.
+### View
+Presentational classes are placed here: [Views](../views.md), [Cells](../views/cells.md), [Helpers](../views/helpers.md).
 
-> [!NOTE]
-> The folder `Command` is not present by default.
-> You can add it when you need it.

docs/en/intro/where-to-get-help.md

@@ -38,10 +38,8 @@ framework. It's a straight forward code reference, so bring your propeller hat.
 ## The Test Cases
 
 If you ever feel the information provided in the API is not sufficient, check
-out the code of the test cases provided with CakePHP. They can serve as
-practical examples for function and data member usage for a class. :
-
-    tests/TestCase/
+out the code of the test cases provided with CakePHP in `tests/TestCase/`.
+They can serve as practical examples for function and data member usage for a class.
 
 ## Slack