improve SEO

Author: LordSimal

docs/en/appendices.md

@@ -1,3 +1,8 @@
+---
+title: "Appendices"
+description: "Appendices contain information regarding the new features introduced in each version and the migration path between versions."
+---
+
 # 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: "CakePHP 5.0 contains breaking changes, and is not backwards compatible with 4.x releases."
+---
+
 # 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: "First, check that your application is running on latest CakePHP 4.x version."
+---
+
 # 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: "The 5.1.0 release is backwards compatible with 5.0. It adds new functionality and introduces new deprecations."
+---
+
 # 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: "The 5.2.0 release is backwards compatible with 5.0. It adds new functionality and introduces new deprecations."
+---
+
 # 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: "The 5.3.0 release is backwards compatible with 5.0. It adds new functionality and introduces new deprecations."
+---
+
 # 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: "CakePHP projects broadly follow semver. Minor releases are easier, major releases require some work."
+---
+
 # 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: "A list of commonly used abbreviations and names."
+---
 
-<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: "Migration guides contain information regarding the new features introduced in each version and the migration path between 5.x minor releases."
+---
+
 # 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: "This guide covers the PHPUnit version requirements and migration steps for CakePHP 5.x applications. CakePHP 5.x requires PHPUnit ^11.5.3 or ^12.1.3."
+---
+
 # PHPUnit Upgrade
 
 This guide covers the PHPUnit version requirements and migration steps for CakePHP 5.x applications.