Initial commit: loc_az_hci (smom-dbis-138 excluded via .gitignore)

Co-authored-by: Cursor <cursoragent@cursor.com>

docs/INDEX.md

@@ -0,0 +1,91 @@
+# Documentation Index
+
+This is the master index for all project documentation. Documentation is organized by purpose to make it easy to find what you need.
+
+## Getting Started
+
+- [Quick Start Guide](getting-started/quick-start.md) - Get up and running quickly
+- [Prerequisites](getting-started/prerequisites.md) - System requirements and prerequisites
+- [Installation Guide](getting-started/installation.md) - Step-by-step installation instructions
+
+## Architecture
+
+- [Architecture Overview](architecture/overview.md) - High-level system architecture
+- [Complete Architecture](architecture/complete-architecture.md) - Detailed architecture documentation
+- [Network Topology](architecture/network-topology.md) - Network design and VLAN configuration
+- [Hardware BOM](architecture/hardware-bom.md) - Bill of materials and hardware specifications
+- [PCIe Allocation](architecture/pcie-allocation.md) - PCIe slot allocation map
+- [Driver Matrix](architecture/driver-matrix.md) - Driver compatibility matrix
+
+## Deployment
+
+- [Deployment Guide](deployment/deployment-guide.md) - Complete deployment instructions
+- [Bring-Up Checklist](deployment/bring-up-checklist.md) - Day-one installation checklist
+- [Azure Arc Onboarding](deployment/azure-arc-onboarding.md) - Azure Arc integration guide
+- [Cloudflare Integration](deployment/cloudflare-integration.md) - Cloudflare Tunnel and Zero Trust setup
+
+## Operations
+
+- [Runbooks](operations/runbooks/) - Operational procedures
+  - [Proxmox Operations](operations/runbooks/proxmox-operations.md)
+  - [Azure Arc Troubleshooting](operations/runbooks/azure-arc-troubleshooting.md)
+  - [GitOps Workflow](operations/runbooks/gitops-workflow.md)
+- [Proxmox Ubuntu Images](operations/proxmox-ubuntu-images.md) - Ubuntu image management
+- [Guest Agent Setup](operations/guest-agent-setup.md) - QEMU guest agent configuration
+
+## Troubleshooting
+
+- [Common Issues](troubleshooting/common-issues.md) - Frequently encountered problems and solutions
+- [VM Troubleshooting](troubleshooting/vm-troubleshooting.md) - VM-specific troubleshooting guide
+
+## Security
+
+- [Security Guide](security/security-guide.md) - Security best practices and configuration
+- [Proxmox RBAC](security/proxmox-rbac.md) - Role-based access control for Proxmox
+
+## Reference
+
+- [API Reference](reference/api-reference.md) - API documentation
+- [Command Reference](reference/command-reference.md) - Command-line reference
+
+## Archived Documentation
+
+- [Temporary Files](temporary/) - Archived temporary files and status reports
+
+## Documentation by Topic
+
+### For New Users
+1. Start with [Quick Start Guide](getting-started/quick-start.md)
+2. Review [Prerequisites](getting-started/prerequisites.md)
+3. Follow [Installation Guide](getting-started/installation.md)
+
+### For Deployment
+1. Review [Architecture Overview](architecture/overview.md)
+2. Follow [Deployment Guide](deployment/deployment-guide.md)
+3. Use [Bring-Up Checklist](deployment/bring-up-checklist.md)
+
+### For Operations
+1. Review [Runbooks](operations/runbooks/)
+2. Check [Common Issues](troubleshooting/common-issues.md) for problems
+3. Refer to [Command Reference](reference/command-reference.md) for commands
+
+### For Troubleshooting
+1. Check [Common Issues](troubleshooting/common-issues.md)
+2. Review relevant [Runbooks](operations/runbooks/)
+3. Consult [VM Troubleshooting](troubleshooting/vm-troubleshooting.md)
+
+## Contributing to Documentation
+
+When adding or updating documentation:
+
+1. Place files in the appropriate directory
+2. Update this index
+3. Ensure cross-references are correct
+4. Follow the documentation style guide (to be created)
+
+## Documentation Maintenance
+
+- Documentation index is auto-generated by `scripts/docs/generate-docs-index.sh`
+- Broken links are validated by `scripts/docs/validate-docs.sh`
+- Diagrams are updated by `scripts/docs/update-diagrams.sh`
+