Merge pull request #248 from dotkernel/wsl2-page1

pages

Author: arhimede

public/admin.md

@@ -16,6 +16,8 @@ A fast, reliable way to manage the records in your database with a simple table-
 - [View on GitHub](https://github.com/dotkernel/admin)
 - [Live demo](https://admin7.dotkernel.net/)
 
+PHP 8.3, 8.4 or 8.5 . [Latest release](https://github.com/dotkernel/admin/releases/latest)
+
 | | |
 | --- | --- |
 | Runtime | Mezzio + Laminas |
@@ -210,7 +212,7 @@ If the fixtures ran, sign in with user `admin` and password `dotadmin` - the sam
 | Operating system | A \*nix based system is strongly recommended for production. |
 | PHP | 8.3 or newer, mod_php or FCGI (FPM). `memory_limit` at least 128M; `upload_max_filesize` and `post_max_size` at least 100M depending on your data. |
 | Web server | Apache 2.2+ with `mod_rewrite` and `.htaccess` support (`AllowOverride All`) - a default `.htaccess` ships in `public/`. On Nginx, translate it into server configuration. |
-| Database | MariaDB 10.7, 10.11 LTS, 11.4 LTS and 11.8 LTS, or PostgreSQL 13 and above. **MySQL is not supported**, as it has no UUID support. |
+| Database | MariaDB 11.4 LTS, 11.8 LTS and 12.3 LTS, or PostgreSQL 13 and above. **MySQL is not supported**, as it has no UUID support. |
 | Required extensions | `mbstring`, the CLI SAPI for cron jobs, and Composer available on `$PATH`. |
 | Recommended extensions | `opcache`; `pdo_mysql`, `pdo_pgsql` or `mysqli` to match your database; `dom` and `simplexml` for markup; `gd` and `exif` for images; `zlib`, `zip`, `bz2` for compression; `curl` when calling APIs; `sqlite3` for the test suite. |
 

public/api.md

@@ -16,6 +16,8 @@ OAuth 2.0, RBAC authorization, HAL payloads, standardized error responses and an
 - [View on GitHub](https://github.com/dotkernel/api)
 - [Live demo](https://api.dotkernel.net/)
 
+PHP 8.3, 8.4 or 8.5 . [Latest release](https://github.com/dotkernel/api/releases/latest)
+
 | | |
 | --- | --- |
 | Runtime | Mezzio + Laminas |
@@ -130,11 +132,11 @@ You keep full control of the UUID version without depending on database extensio
 ### PostgreSQL support
 
 PostgreSQL joins the supported databases.
-Because native UUID is required, you need PostgreSQL or MariaDB 10.7 or later; MySQL is no longer supported, as it has no UUID data type.
+Because native UUID is required, you need PostgreSQL 13+ or MariaDB 11.4 or later; MySQL is no longer supported, as it has no UUID data type.
 
 ### PHP 8.5
 
-The API targets PHP 8.5, with Dotkernel Admin on 8.4.
+The API and Admin target PHP 8.5.
 Dependencies are kept current, and the ecosystem's own packages track the versions Laminas and Doctrine support.
 
 ### Table prefixes
@@ -176,7 +178,7 @@ The comparison below is drawn from the full side-by-side write-up on our blog.
 | First release | 2012 | 2018 |
 | Architecture | MVC, event driven | Middleware |
 | OSS lifecycle | Archived | Active |
-| PHP version | ≤ 8.2 | See the PHP version badge for `dotkernel/api` |
+| PHP version | ≤ 8.2 | 8.3, 8.4 or 8.5 |
 | Style | REST, RPC | REST |
 | Change management | Versioning | Deprecations (API evolution) |
 | Documentation | Swagger (automated) | OpenAPI 3.0 (Swagger) and Postman (manual) |
@@ -283,7 +285,7 @@ Updates arrive with bugfixes and improvements from the PHP community, and breaki
 
 ## Install it and call an endpoint
 
-Create the project with Composer, point it at PostgreSQL or MariaDB 10.7+, run the migrations, and you have an authenticated REST API with a browsable OpenAPI specification.
+Create the project with Composer, point it at PostgreSQL 13+ or MariaDB 11.4+, run the migrations, and you have an authenticated REST API with a browsable OpenAPI specification.
 
 - [Installation guide](https://docs.dotkernel.org/api-documentation/)
 - [Try the demo](https://api.dotkernel.net/)

public/architecture.md

@@ -22,7 +22,7 @@ A request enters at the error boundary, passes through routing, negotiation, aut
 | Container | PSR-11 |
 | Logging | PSR-3 |
 
-## Five phases, 19 stages
+## Six phases, 19 stages
 
 Error boundary (1 stage) -> Request preparation (4 stages) -> Routing (4 stages) -> Contract & headers (4 stages) -> Identity (2 stages) -> Dispatch & fallback (4 stages).
 

public/frontend.md

@@ -221,7 +221,7 @@ Duplicating `local.test.php.dist` gives your tests an in-memory database.
 | Required extensions | `curl`, `gettext`, `intl`, `json`, `mbstring`, the CLI SAPI for cron jobs, and Composer on `$PATH`. |
 | Recommended extensions | `opcache`; `pdo_mysql` for MySQL or MariaDB; `dom` and `simplexml` for markup; `gd` and `exif` for images; `zlib`, `zip`, `bz2` for compression; `sqlite3` for the test suite. |
 
-Note that Frontend still supports MySQL - unlike API and Admin v7, which require native UUID support and therefore PostgreSQL or MariaDB 10.7+.
+Note that Frontend still supports MySQL - unlike API and Admin v7, which require native UUID support and therefore PostgreSQL 13+ or MariaDB 11.4+.
 
 ## Where Frontend sits
 

public/queue.md

@@ -201,7 +201,7 @@ valkey-cli ping
 
 ### 4 . Clone and configure
 
-Clone the queue branch, then copy each `.dist` configuration file into place - local, log, messenger and swoole - and fill them in.
+Clone the queue repo, then copy each `.dist` configuration file into place - local, log, messenger and swoole - and fill them in.
 
 ```shell
 git clone https://github.com/dotkernel/queue.git

src/App/templates/layout/default.html.twig

@@ -53,6 +53,7 @@
                             <li><a class="dropdown-item" href="{{ url('page::dotboost') }}">Dotboost</a></li>
                             <li><a class="dropdown-item" href="{{ url('page::light') }}">Light</a></li>
                             <li><a class="dropdown-item" href="{{ url('page::frontend') }}">Frontend</a></li>
+                            <li><a class="dropdown-item" href="{{ url('page::wsl2') }}">WSL2 Dev Stack</a></li>
                         </ul>
                     </li>
                     <li class="nav-item"><a class="nav-link" href="{{ url('page::architecture') }}">Architecture</a></li>

src/Page/templates/page/admin.html.twig

@@ -432,7 +432,7 @@
                         </tr>
                         <tr>
                             <th scope="row">PHP</th>
-                            <td>8.2 or newer, mod_php or FCGI (FPM). <code>memory_limit</code> at least 128M;
+                            <td>8.3 or newer, mod_php or FCGI (FPM). <code>memory_limit</code> at least 128M;
                                 <code>upload_max_filesize</code> and <code>post_max_size</code> at least 100M depending
                                 on your data.</td>
                         </tr>

src/Page/templates/page/api.html.twig

@@ -383,7 +383,7 @@
                 </div>
                 <div class="standard">
                     <h4>PHP 8.5</h4>
-                    <p>The API and Admin target PHP 8.5. Dependencies are kept current, and the
+                    <p>The API targets PHP 8.5, with Dotkernel Admin on 8.4. Dependencies are kept current, and the
                        ecosystem's own packages track the versions Laminas and Doctrine support.</p>
                 </div>
                 <div class="standard">

src/Page/templates/page/architecture.html.twig

@@ -107,7 +107,7 @@
 
             <div class="hero-visual">
                 <div class="pipeline">
-                    <div class="pipeline-label"><span>Five phases</span><span>19 stages</span></div>
+                    <div class="pipeline-label"><span>Six phases</span><span>19 stages</span></div>
                     <div class="blocks-tower">
                         <div class="block" style="width:100%; background:var(--brand-red)"><span class="name">Error boundary</span><span class="tag">1 stage</span></div>
                         <div class="block" style="width:84%; background:var(--periwinkle)"><span class="name">Request preparation</span><span class="tag">4 stages</span></div>

src/Page/templates/page/dotboost.html.twig

@@ -266,8 +266,8 @@
                         <tr><th scope="row">git rebase</th><td>ask</td><td>blocks</td></tr>
                         <tr><th scope="row">doctrine-migrations migrate / execute</th><td>ask</td><td>blocks</td></tr>
                         <tr><th scope="row">fixtures:execute, schema:drop, schema:update</th><td>ask, via bin/cli.php</td><td>blocks</td></tr>
-                        <tr><th scope="row">composer development-enable / -disable</th><td>—</td><td>blocks</td></tr>
-                        <tr><th scope="row">pip install, git checkout --, git filter-branch</th><td>—</td><td>blocks</td></tr>
+                        <tr><th scope="row">composer development-enable / -disable</th><td>-</td><td>blocks</td></tr>
+                        <tr><th scope="row">pip install, git checkout --, git filter-branch</th><td>-</td><td>blocks</td></tr>
                     </tbody>
                 </table>
             </div>