feat: implement documentation aggregation system

Signed-off-by: Emilien Escalle <emilien.escalle@escemi.com>

Author: Copilot

.env

@@ -37,6 +37,28 @@ jobs:
       name: github-pages
       url: ${{ steps.deployment.outputs.url }}
     steps:
+      - id: generate-github-actions-docs
+        uses: hoverkraft-tech/ci-dokumentor@c46a1a108957237cf485103a80b060c35c7dba33 # 0.2.2
+        with:
+          source: .github/workflows/sync-docs-push.yml
+
+      - uses: actions/create-github-app-token@67018539274d69449ef7c02e8e71183d1719ab42 # v2.1.4
+        id: generate-token
+        with:
+          app-id: ${{ vars.CI_BOT_APP_ID }}
+          private-key: ${{ secrets.CI_BOT_APP_PRIVATE_KEY }}
+
+      - uses: hoverkraft-tech/ci-github-common/actions/create-and-merge-pull-request@b7dd413209df265bef8d7eb0efb117eaabc684c4 # 0.27.0
+        with:
+          github-token: ${{ steps.generate-token.outputs.token }}
+          branch: docs/action-documentation-update
+          title: "docs: update action documentation"
+          body: Update action documentation
+          commit-message: |
+            docs: update action documentation
+
+            [skip ci]
+
       - id: deployment
         uses: hoverkraft-tech/ci-github-publish/actions/deploy/github-pages@0.12.1
         with:

.github/scripts/generate-docs.js

@@ -0,0 +1,111 @@
+<!-- header:start -->
+
+# GitHub Reusable Workflow: Push Documentation Helper
+
+<div align="center">
+  <img src="https://opengraph.githubassets.com/ee8743035f4d97b88b8e03937037b13ca280a32c2398978b76e268b0fa4cf3b1/hoverkraft-tech/public-docs" width="60px" align="center" alt="Push Documentation Helper" />
+</div>
+
+---
+
+<!-- header:end -->
+<!-- badges:start -->
+
+[![Release](https://img.shields.io/github/v/release/hoverkraft-tech/public-docs)](https://github.com/hoverkraft-tech/public-docs/releases)
+[![License](https://img.shields.io/github/license/hoverkraft-tech/public-docs)](http://choosealicense.com/licenses/mit/)
+[![Stars](https://img.shields.io/github/stars/hoverkraft-tech/public-docs?style=social)](https://img.shields.io/github/stars/hoverkraft-tech/public-docs?style=social)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/hoverkraft-tech/public-docs/blob/main/CONTRIBUTING.md)
+
+<!-- badges:end -->
+<!-- overview:start -->
+
+## Overview
+
+Reusable workflow that bundles project docs and triggers public portal sync
+
+- Collects readme and docs Markdown, adds sync metadata, and uploads a short-lived artifact
+- Dispatches a repository event so hoverkraft-tech/public-docs can ingest and publish updates
+
+<!-- overview:end -->
+<!-- usage:start -->
+
+## Usage
+
+```yaml
+name: Push Documentation Helper
+on:
+  push:
+    branches:
+      - main
+jobs:
+  sync-docs-dispatcher:
+    uses: hoverkraft-tech/public-docs/.github/workflows/sync-docs-dispatcher.yml@4ab9c098ba58ed7f19ae6e879516c04ed5379d1a # copilot/centralize-project-documentation
+    secrets:
+      # GitHub token with write access to trigger repository_dispatch in public-docs
+      # This input is required.
+      PUBLIC_DOCS_TOKEN: ""
+    with:
+      # Path to documentation in source repo (default: docs)
+      # Default: `docs`
+      docs_path: docs
+
+      # Include README.md from repository root
+      # Default: `true`
+      include_readme: true
+```
+
+<!-- usage:end -->
+<!-- inputs:start -->
+
+## Inputs
+
+### Workflow Call Inputs
+
+| **Input**            | **Description**                                      | **Required** | **Type**    | **Default** |
+| -------------------- | ---------------------------------------------------- | ------------ | ----------- | ----------- |
+| **`docs_path`**      | Path to documentation in source repository (default: docs) | **false**    | **string**  | `docs`      |
+| **`include_readme`** | Include README.md from repository root               | **false**    | **boolean** | `true`      |
+
+<!-- inputs:end -->
+<!-- secrets:start -->
+
+## Secrets
+
+| **Secret**              | **Description**                                                              | **Required** |
+| ----------------------- | ---------------------------------------------------------------------------- | ------------ |
+| **`PUBLIC_DOCS_TOKEN`** | GitHub token with write access to trigger repository_dispatch in public-docs | **true**     |
+
+<!-- secrets:end -->
+<!-- outputs:start -->
+<!-- outputs:end -->
+<!-- examples:start -->
+<!-- examples:end -->
+<!-- contributing:start -->
+
+## Contributing
+
+Contributions are welcome! Please see the [contributing guidelines](https://github.com/hoverkraft-tech/public-docs/blob/main/CONTRIBUTING.md) for more details.
+
+<!-- contributing:end -->
+<!-- security:start -->
+<!-- security:end -->
+<!-- license:start -->
+
+## License
+
+This project is licensed under the MIT License.
+
+SPDX-License-Identifier: MIT
+
+Copyright © 2025 hoverkraft-tech
+
+For more details, see the [license](http://choosealicense.com/licenses/mit/).
+
+<!-- license:end -->
+<!-- generated:start -->
+
+---
+
+This documentation was automatically generated by [CI Dokumentor](https://github.com/hoverkraft-tech/ci-dokumentor).
+
+<!-- generated:end -->