improve SEO (#8220)

* improve SEO

* update to use summarized descriptions

---------

Co-authored-by: Jasper Smet <josbeir@gmail.com>

Author: LordSimal

docs/en/appendices.md

@@ -1,3 +1,8 @@
+---
+title: "Appendices"
+description: "CakePHP appendices: access migration guides, glossary, upgrade paths, development process info, and version-specific documentation."
+---
+
 # Appendices
 
 Appendices contain information regarding the new features

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

@@ -1,3 +1,8 @@
+---
+title: "5.0 Migration Guide"
+description: "Upgrade to CakePHP 5.0: migrate from 4.x, handle breaking changes, update code, understand new requirements and deprecation removals."
+---
+
 # 5.0 Migration Guide
 
 CakePHP 5.0 contains breaking changes, and is not backwards compatible with 4.x

docs/en/appendices/5-0-upgrade-guide.md

@@ -1,3 +1,8 @@
+---
+title: "5.0 Upgrade Guide"
+description: "Upgrade to CakePHP 5.0 from 4.x. Fix deprecations, update to PHP 8.1+, run rector tool, and update dependencies following this step-by-step guide."
+---
+
 # 5.0 Upgrade Guide
 
 First, check that your application is running on latest CakePHP 4.x version.

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

@@ -1,3 +1,8 @@
+---
+title: "5.1 Migration Guide"
+description: "Migrate to CakePHP 5.1: explore new features, deprecations, improvements, and upgrade your 5.0 application with this comprehensive guide."
+---
+
 # 5.1 Migration Guide
 
 The 5.1.0 release is backwards compatible with 5.0. It adds new functionality

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

@@ -1,3 +1,8 @@
+---
+title: "5.2 Migration Guide"
+description: "Migrate to CakePHP 5.2: understand new features, deprecations, breaking changes, and upgrade your application from 5.0/5.1 smoothly."
+---
+
 # 5.2 Migration Guide
 
 The 5.2.0 release is backwards compatible with 5.0. It adds new functionality

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

@@ -1,3 +1,8 @@
+---
+title: "5.3 Migration Guide"
+description: "Upgrade to CakePHP 5.3: discover new features, deprecations, improvements, and migrate from 5.0-5.2 with this detailed guide."
+---
+
 # 5.3 Migration Guide
 
 The 5.3.0 release is backwards compatible with 5.0. It adds new functionality

docs/en/appendices/cakephp-development-process.md

@@ -1,3 +1,8 @@
+---
+title: "CakePHP Development Process"
+description: "Understand CakePHP development: release cycles, semantic versioning, contribution workflow, and how the framework evolves over time."
+---
+
 # CakePHP Development Process
 
 CakePHP projects broadly follow [semver](https://semver.org/). This means that:

docs/en/appendices/glossary.md

@@ -1,31 +1,34 @@
-# Glossary
+---
+title: "Glossary"
+description: "CakePHP terminology reference: understand common abbreviations, technical terms, and framework-specific vocabulary used in documentation."
+---
 
-<div class="glossary">
+# Glossary
 
-CDN
+## CDN
 Content Delivery Network. A 3rd party vendor you can pay to help
 distribute your content to data centers around the world. This helps
 put your static assets closer to geographically distributed users.
 
-columns
+## columns
 Used in the ORM when referring to the table columns in an database
 table.
 
-CSRF
+## CSRF
 Cross Site Request Forgery. Prevents replay attacks, double
 submissions and forged requests from other domains.
 
-DI Container
+## DI Container
 In `Application::services()` you can configure application services
 and their dependencies. Application services are automatically injected
 into Controller actions, and Command Constructors. See
 [Dependency Injection](../development/dependency-injection).
 
-DSN
+## DSN
 Data Source Name. A connection string format that is formed like a URI.
 CakePHP supports DSNs for Cache, Database, Log and Email connections.
 
-dot notation
+## dot notation
 Dot notation defines an array path, by separating nested levels with `.`
 For example:
 
@@ -43,17 +46,17 @@ Would point to the following value:
 ]
 ```
 
-DRY
+## DRY
 Don't repeat yourself. Is a principle of software development aimed at
 reducing repetition of information of all kinds. In CakePHP DRY is used
 to allow you to code things once and re-use them across your
 application.
 
-fields
+## fields
 A generic term used to describe both entity properties, or database
 columns. Often used in conjunction with the FormHelper.
 
-HTML attributes
+## HTML attributes
 An array of key => values that are composed into HTML attributes. For example:
 
 ``` php
@@ -75,15 +78,15 @@ can be used:
 checked="checked"
 ```
 
-PaaS
+## PaaS
 Platform as a Service. Platform as a Service providers will provide
 cloud based hosting, database and caching resources. Some popular
 providers include Heroku, EngineYard and PagodaBox
 
-properties
+## properties
 Used when referencing columns mapped onto an ORM entity.
 
-plugin syntax
+## plugin syntax
 Plugin syntax refers to the dot separated class name indicating classes
 are part of a plugin:
 
@@ -95,18 +98,16 @@ are part of a plugin:
 'AcmeCorp/Tools.Toolbar'
 ```
 
-routes.php
+## routes.php
 A file in the `config/` directory that contains routing configuration.
 This file is included before each request is processed.
 It should connect all the routes your application needs so
 requests can be routed to the correct controller + action.
 
-routing array
+## routing array
 An array of attributes that are passed to `Router::url()`.
 They typically look like:
 
 ``` php
 ['controller' => 'Posts', 'action' => 'view', 5]
 ```
-
-</div>

docs/en/appendices/migration-guides.md

@@ -1,3 +1,8 @@
+---
+title: "Migration Guides"
+description: "Upgrade CakePHP versions: follow migration guides for each release, understand breaking changes, and smoothly transition between versions."
+---
+
 # Migration Guides
 
 Migration guides contain information regarding the new features introduced in

docs/en/appendices/phpunit-upgrade.md

@@ -1,3 +1,8 @@
+---
+title: "PHPUnit Upgrade"
+description: "Upgrade PHPUnit in CakePHP 5.x: migrate tests to PHPUnit 11+, update assertions, configure test suites, and maintain compatibility."
+---
+
 # PHPUnit Upgrade
 
 This guide covers the PHPUnit version requirements and migration steps for CakePHP 5.x applications.