[docs] Add mascot artwork to README and docs (#121) (#122)

* [docs] Add mascot artwork to README and docs (#121)

* Update wiki submodule pointer for PR #122

* [docs] Refine mascot presentation (#121)

* [docs] Update phpDocumentor template to v2 (#121)

* [changelog] Record phpDocumentor template upgrade (#121)

---------

Co-authored-by: github-actions <41898282+github-actions[bot]@users.noreply.github.com>

Author: coisa

.github/wiki

@@ -10,6 +10,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Changed
 
 - Document required GitHub Actions permissions for changelog release automation (#118)
+- Add the project mascot image to README and documentation (#121)
+- Upgrade the packaged phpDocumentor bootstrap template to v2.0.0 (#121)
 
 ## [1.12.0] - 2026-04-19
 

CHANGELOG.md

@@ -13,6 +13,10 @@ across Fast Forward libraries.
 [![License](https://img.shields.io/github/license/php-fast-forward/dev-tools?color=64748B)](LICENSE)
 [![GitHub Sponsors](https://img.shields.io/github/sponsors/php-fast-forward?logo=githubsponsors&logoColor=white&color=EC4899)](https://github.com/sponsors/php-fast-forward)
 
+<p align="center">
+  <img src="docs/_static/mascot-banner.png" alt="Fast Forward DevTools mascot" width="840">
+</p>
+
 ## ✨ Features
 
 - Aggregates refactoring, PHPDoc, code style, tests, and reporting under a

README.md

@@ -45,7 +45,7 @@
         "ergebnis/composer-normalize": "^2.51",
         "ergebnis/rector-rules": "^1.18",
         "fakerphp/faker": "^1.24",
-        "fast-forward/phpdoc-bootstrap-template": "^1.0",
+        "fast-forward/phpdoc-bootstrap-template": "^2.0",
         "friendsofphp/php-cs-fixer": "^3.95",
         "icanhazstring/composer-unused": "^0.9.6",
         "jolicode/jolinotif": "^3.3",

composer.json

@@ -1,18 +1,32 @@
 Documentation
 =============
 
-FastForward DevTools is infrastructure for Fast Forward libraries. It ships
-shared defaults, registers Composer commands, generates documentation, and
-synchronizes automation plus packaged agent skills into consumer repositories.
+.. container:: row align-items-center gy-4 my-4
 
-If you are new to the package, start with :doc:`getting-started/index` and
-:doc:`usage/index`. If you maintain Fast Forward libraries, continue with
-:doc:`advanced/index`, :doc:`api/index`, and :doc:`internals/index` to
-understand how the Composer plugin, PHPUnit extension, and reusable workflows
-fit together.
+   .. container:: col-lg-7
+
+      FastForward DevTools is the shared infrastructure layer for Fast Forward
+      libraries. It keeps Composer commands, documentation generation,
+      reporting, workflow automation, and packaged agent skills moving in the
+      same direction.
+
+      If you are new to the package, start with
+      :doc:`getting-started/index` and :doc:`usage/index` for installation, the
+      first successful run, and the core command flow.
+
+      If you maintain Fast Forward libraries, continue with
+      :doc:`advanced/index`, :doc:`api/index`, and :doc:`internals/index` to
+      understand how the Composer plugin, PHPUnit extension, and reusable
+      workflows fit together.
+
+   .. container:: col-lg-5 text-center
+
+      .. image:: _static/mascot.png
+         :alt: Fast Forward DevTools mascot
+         :class: img-fluid w-100 rounded-4 shadow-sm border border-light-subtle bg-body-tertiary p-2
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
    :caption: Contents
 
    getting-started/index

docs/_static/mascot-banner.png

@@ -35,7 +35,7 @@
             <source dsn="{{ workingDirectory }}">
                 <path>{{ guidePath }}</path>
             </source>
-            <output>guide</output>
+            <output>.</output>
         </guide>
     </version>
-</phpdocumentor>
+</phpdocumentor>