Enterprise-Grade Documentation as Code Ecosystem

The 40docs platform is a comprehensive multi-repository ecosystem that manages 25+ interconnected repositories through Git submodules and automation. It provides a secure, scalable infrastructure for documentation, security labs, and cloud-native applications using Azure Kubernetes Service (AKS) with GitOps workflows.

40Docs demonstrates how organizations can implement Documentation as Code with full infrastructure automation, security-first design, and developer experience optimization at enterprise scale.

• 📚 Documentation as Code: Version-controlled content with automated MkDocs builds, theme inheritance, and PDF generation
• ☁️ Cloud-Native Infrastructure: Azure hub-spoke network with FortiWeb NVA and AKS cluster
• 🛡️ Security-First Design: Zero-trust architecture with Lacework monitoring and cert-manager automation
• 🔄 GitOps Workflows: Flux v2 continuous deployment with multi-repository orchestration
• 🧑‍💻 Developer Experience: Comprehensive DevContainer support with 75+ tools and AI-powered collaboration
• ⚡ AI-Powered Orchestration: Claude Code orchestrator for intelligent multi-repository management

• hydration - Master orchestrator for GitHub/Azure authentication, SSH keys, secrets management, Terraform provisioning, and Kubernetes GitOps
• infrastructure - Azure hub-spoke architecture with FortiWeb NVA, AKS deployment, cert-manager, and Lacework monitoring
• manifests-infrastructure - Kubernetes infrastructure manifests and GitOps configurations
• manifests-applications - Application deployment manifests and Helm charts

• mkdocs - Docker container system with Material theme, 40+ plugins, and Playwright PDF generation
• docs-builder - Automated Docker image creation for documentation websites with semantic versioning
• theme - Shared Material theme and styling components with advanced features
• references - Technical documentation and reference materials
• landing-page - Marketing and navigation hub

• devcontainer-templates - Ubuntu 22.04 with 75+ tools for cloud, security, and DevOps development
• devcontainer-features - 40+ custom DevContainer features for specialized development workflows
• dotfiles - Configuration files and development environment setup

• pebcak - FortiCNAPP OPAL educational lab with three-phase Policy as Code progression
• docs-forticnapp-code-security - Educational content for SCA, IaC, and SAST security practices
• lab-forticnapp-code-security - Hands-on security lab environments
• container-security-demo - Container security demonstration and testing
• fortiweb-ingress - Kubernetes ingress controller for FortiWeb

• video-as-code & video-producer-microservice - Automated video content generation
• tts-microservices - Text-to-speech processing services
• pptx-extractor-microservice - PowerPoint content extraction and processing
• webhook - Event-driven automation and integration services

• 25+ Repositories - Complete ecosystem management with Git submodules
• 2,100+ Lines - Enterprise-grade automation in hydration orchestrator
• 75+ Development Tools - Comprehensive DevContainer environment
• 40+ MkDocs Plugins - Advanced documentation generation capabilities
• Multi-Cloud Ready - Azure-native with extensible architecture
• Production Ready - High availability and scalability built-in

• 🔒 Zero-Trust Architecture - All traffic inspected through FortiWeb NVA with hub-spoke topology
• 🔍 Continuous Monitoring - Lacework security agent deployment and runtime protection
• 📜 Policy as Code - Automated compliance and governance with FortiCNAPP OPAL
• 🔐 Secrets Management - Azure Key Vault and GitHub Secrets integration with automated rotation
• 🛠️ RBAC Integration - Azure AD authentication with Kubernetes RBAC
• 📋 Certificate Automation - cert-manager with Let's Encrypt integration

# Open in GitHub Codespaces - includes all tools and authentication
# Click the "Open in GitHub Codespaces" badge above

# Or clone and initialize locally
git clone --recurse-submodules https://github.com/40docs/.github.git ~/40docs
cd ~/40docs

# Authenticate with GitHub and Azure
gh auth login
az login --use-device-code

# Initialize the entire platform
cd hydration && ./install.sh --initialize

# Fork the entire ecosystem
gh repo fork 40docs/.github --clone
cd .github/hydration

# Edit config.json with your organization settings
# Configure DNS zone, project name, and repository list
./install.sh --initialize

Visit our deployed applications to see the platform in action:

• Documentation as Code - Scale documentation across multiple teams and repositories
• Platform Engineering - Reference architecture for developer platforms and self-service infrastructure
• Security Operations - Comprehensive scanning, monitoring, and vulnerability management
• GitOps Implementation - Modern continuous deployment with Flux v2 and Kubernetes

• Infrastructure Patterns - Terraform and Kubernetes best practices with Azure integration
• Security Best Practices - Hands-on security labs with FortiCNAPP
• Documentation Guide - Complete Documentation as Code implementation guide
• DevOps Workflows - Multi-repository automation and orchestration patterns

• Code Security Scanning - SAST/DAST with FortiCNAPP integration and Policy as Code
• Container Security - Runtime protection, vulnerability management, and compliance
• Infrastructure as Code - Terraform automation, Azure best practices, and GitOps workflows
• Documentation Automation - MkDocs theming, PDF generation, and multi-repository builds

Azure Cloud Platform | AKS + Flux v2 GitOps | FortiWeb NVA Security | MkDocs + Material Theme | Terraform IaC | DevContainers + VSCode | Claude Code AI

1. Fork the repository you want to contribute to
2. Create a feature branch following naming conventions
3. Develop using provided DevContainer environments
4. Test your changes locally with validation scripts
5. Submit pull request with detailed description

• Documentation-only PRs are auto-approved for repository owners
• Comprehensive CI/CD with Terraform validation, security scanning, and automated testing
• GitOps deployment with automatic rollback on failures

Ready to revolutionize your documentation and infrastructure workflow?

🚀 Get Started Now | 📚 View Documentation | 🔒 Try Security Labs

Built with ❤️ by the 40docs team - Empowering organizations with enterprise-grade Documentation as Code practices and AI-powered development workflows