chore(docs): move the documentation sources out of the repository

.gitignore

@@ -11,3 +11,7 @@ ssl/certs/
 *.swp
 *.swo
 *~
+
+# Documentation sources live on the host only; the site publishes the generated
+# pages from forail-platform.github.io.
+docs/

CONTRIBUTING.md

@@ -1,14 +1,15 @@
 # Contributing to Forail Platform
 
-This repository is the canonical home of the **full contributing guide** for the whole Forail Platform project — git workflow, commit conventions, coding standards, PR process across all repos.
+The **full contributing guide** — git workflow, commit conventions, coding standards, PR process across all repos — is published on the developer docs site.
 
-**Read first:** [docs/10-contributing-guide.md](./docs/10-contributing-guide.md)
+**Read first:** <https://forail-platform.github.io/dev/contributing.html>
+
+The markdown sources for that site are kept outside this repository.
 
 ## What lives here
 
 - Docker Compose deployment stack (production and development overlays)
 - Install scripts and bootstrap
-- Cross-repo documentation (architecture, deployment, ops, contributing)
 - Release notes for the platform as a whole
 
 ## Quick start (deploy stack)
@@ -20,7 +21,7 @@ cp .env.example .env
 docker compose up -d
 ```
 
-See [README.md](./README.md) and `docs/` for full setup.
+See [README.md](./README.md) for full setup.
 
 ## Reporting bugs
 

README.md

@@ -88,31 +88,24 @@ forail-devops/
 ├── receptor/                # Receptor mesh configuration
 ├── scripts/                 # Backup, restore, health checks
 ├── settings/                # Django production settings
-├── docs/                    # All documentation
 ├── .env.example             # Environment template
 └── .github/workflows/       # GitHub Actions CI/CD
 ```
 
 ## Documentation
 
-### Deployment
-- [Architecture Overview](docs/01-architecture-overview.md)
-- [Docker Deployment](docs/07-docker-deployment.md)
-- [CI/CD Pipeline](docs/08-ci-cd-pipeline.md)
-- [CI Pipeline Reference](docs/ci-pipeline-reference.md)
-- [Contributing Guide](docs/10-contributing-guide.md)
-
-### Plans
-- [Separation Plan](docs/plan_separation.md)
-- [Development Plan](docs/plan_development.md)
-- [Detailed Plan](docs/plan_detailed.md)
-- [Future Development](docs/future_development_plan.md)
-- [Chat/AI Assistant Plan](docs/chat_plan.md)
-- [Mobile App Plan](docs/mobile_plan.md)
+Published on the developer and user docs site — the markdown sources are kept
+outside this repository:
+
+- [Architecture Overview](https://forail-platform.github.io/docs/architecture.html)
+- [Docker Deployment](https://forail-platform.github.io/docs/deployment.html)
+- [CI/CD Pipeline](https://forail-platform.github.io/dev/ci-cd.html)
+- [Contributing Guide](https://forail-platform.github.io/dev/contributing.html)
+- [User Handbook](https://forail-platform.github.io/docs/user-handbook.html)
+- [Administrator Handbook](https://forail-platform.github.io/docs/admin-handbook.html)
 
 ### Release
-- [Release Notes v2026.03.0](docs/RELEASE_NOTES_v2026.03.0.md)
-- [Start & Run Guide](docs/startrun.md)
+- [Release notes](https://forail-platform.github.io/docs/) — one page per release
 
 ## Backup & Restore