Add Docusaurus documentation site with GitHub Pages deployment

Co-authored-by: jorge07 <4022187+jorge07@users.noreply.github.com>

Author: Copilot

.github/workflows/deploy-docs.yml

@@ -0,0 +1,63 @@
+name: Deploy Documentation to GitHub Pages
+
+on:
+  push:
+    branches:
+      - master
+    paths:
+      - 'doc/**'
+      - 'docs-site/**'
+      - '.github/workflows/deploy-docs.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          cache-dependency-path: docs-site/package-lock.json
+          
+      - name: Install dependencies
+        run: |
+          cd docs-site
+          npm ci
+          
+      - name: Build documentation
+        run: |
+          cd docs-site
+          npm run build
+          
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+        
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs-site/build
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -26,4 +26,11 @@ build/
 /.php_cs.cache
 /.phpunit.result.cache
 ###< friendsofphp/php-cs-fixer ###
-etc/artifact/chart/charts/
+etc/artifact/chart/charts/
+
+###> docusaurus ###
+docs-site/node_modules/
+docs-site/build/
+docs-site/.docusaurus/
+docs-site/.cache-loader/
+###< docusaurus ###

README.md

@@ -24,6 +24,10 @@ This project showcases:
 
 ## Documentation
 
+📖 **[View the full documentation site](https://jorge07.github.io/symfony-6-es-cqrs-boilerplate/)**
+
+The documentation is also available in this repository:
+
 ### 📚 Core Concepts
 
 **Domain-Driven Design (DDD)**

docs-site/.gitignore

@@ -0,0 +1,20 @@
+# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

docs-site/README.md

@@ -0,0 +1,54 @@
+# Documentation Site
+
+This directory contains the Docusaurus site for the Symfony 6 ES CQRS Boilerplate documentation.
+
+## Development
+
+### Installation
+
+```bash
+cd docs-site
+npm install
+```
+
+### Local Development
+
+```bash
+npm start
+```
+
+This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+
+### Build
+
+```bash
+npm run build
+```
+
+This command generates static content into the `build` directory and can be served using any static contents hosting service.
+
+### Deployment
+
+The documentation is automatically deployed to GitHub Pages when changes are pushed to the `master` branch.
+
+You can also manually deploy using:
+
+```bash
+GIT_USER=<Your GitHub username> npm run deploy
+```
+
+## Structure
+
+The documentation is organized into the following sections:
+
+- **DDD** - Domain-Driven Design concepts and patterns
+- **CQRS** - Command Query Responsibility Segregation and Event Sourcing
+- **Advanced** - Advanced topics including testing and performance optimization
+- **Getting Started** - Quick start guides and tutorials
+
+## Updating Documentation
+
+1. Make changes to the markdown files in the `../doc` directory
+2. Run the documentation sync script to update the Docusaurus docs
+3. Test locally with `npm start`
+4. Commit and push changes - GitHub Actions will automatically deploy