Skip to content

INDEX.md

Latest commit

 

History

History
193 lines (142 loc) · 12.1 KB

INDEX.md

File metadata and controls

193 lines (142 loc) · 12.1 KB
Raw

Azure Whitepapers — Complete Index

Single source of truth for all published content in this repository.

Last Updated: August 2026 | Maintainer: Randy Bordeaux

Quick Stats

Metric Count
Full whitepapers 31
Architecture briefs 6
Active categories 6 (architecture, compute, storage, networking, security, devops)
Terraform examples 37

Content Tiers

Tier Template Length Terraform KQL
Full Whitepaper templates/whitepaper-template.md 800–1,500 lines Required (examples/) Required
Architecture Brief templates/architecture-brief-template.md 100–300 lines Snippets (examples/) Optional

Cloud Scope

Scope Policy
Azure Commercial Default for all documents
FedRAMP / Regulated Declared in metadata when compliance drives architecture
Out of scope Azure China, Azure Stack, sovereign clouds

Architecture & Design Patterns

Document Type Scope Terraform Example
Azure Well-Architected Framework Whitepaper Commercial examples/architecture/azure-well-architected-framework/
Well-Architected Terraform on Azure Whitepaper Commercial examples/architecture/well-architected-terraform-on-azure/
Azure Cost-Aware Architecture Whitepaper Commercial examples/architecture/azure-cost-aware-architecture/
Operationalizing Azure Monitoring & Observability Whitepaper Commercial examples/architecture/operationalizing-azure-monitoring/
Securing Data Platforms in Azure Commercial Whitepaper Commercial examples/architecture/securing-data-platforms/

📖 Category README

Compute

Document Type Scope Terraform Example
From VMs to Containerized PaaS Whitepaper Commercial, FedRAMP High examples/compute/from-vms-to-containerized-paas/
Azure VM Best Practices Whitepaper Commercial examples/compute/azure-vm-best-practices/

AKS Architecture Briefs

Document Terraform Example
Cluster Architecture and Node Pool Design examples/compute/aks-architecture-briefs/cluster-architecture/
Networking: Kubenet vs Azure CNI examples/compute/aks-architecture-briefs/networking-models/
Identity and RBAC Integration examples/compute/aks-architecture-briefs/identity-rbac/
Security Hardening and Policy examples/compute/aks-architecture-briefs/security-hardening/
Monitoring and Observability examples/compute/aks-architecture-briefs/monitoring-observability/
Cost Optimization examples/compute/aks-architecture-briefs/cost-optimization/

📖 Category README | AKS Briefs README

Storage

Document Scope Terraform Example
Azure Blob Storage Architecture Commercial examples/storage/azure-blob-storage/
Azure Files Enterprise Deployment Commercial examples/storage/azure-files-enterprise/
Azure NetApp Files for Enterprise Commercial examples/storage/azure-netapp-files/
Azure Disk Storage Optimization Commercial examples/storage/azure-disk-storage/
Azure Data Lake Storage Gen2 Commercial examples/storage/azure-data-lake-gen2/

📖 Category README | Planned topics

Networking

Document Scope Terraform Example
Azure Network Security Best Practices Commercial, FedRAMP examples/networking/azure-network-security/
Hub-Spoke Network Topology Commercial examples/networking/hub-spoke-network-topology/
Azure Virtual WAN for FedRAMP High FedRAMP High examples/networking/azure-virtual-wan-fedramp-high/
Network Monitoring and Troubleshooting Commercial examples/networking/network-monitoring-troubleshooting/

📖 Category README

Security & Compliance

Document Scope Terraform Example
Zero Trust Architecture with Azure Services Commercial examples/security/zero-trust-architecture/
Azure AD Implementation and Best Practices Commercial examples/security/azure-ad-implementation/
Key Vault Deployment and Secret Rotation Strategies Commercial examples/security/key-vault-secret-rotation/
Compliance Automation and Governance with Azure Commercial examples/security/compliance-automation-governance/
Azure Security Center and Threat Protection Commercial examples/security/azure-security-center-threat-protection/

📖 Category README

DevOps & Monitoring

Document Scope Terraform Example
Multi-Stage Pipeline Design and Orchestration Commercial examples/devops/multi-stage-pipeline-orchestration/
YAML Pipeline Best Practices and Templates Commercial examples/devops/yaml-pipeline-best-practices/
Pipeline Artifacts and Package Management Commercial examples/devops/pipeline-artifacts-package-management/
Deployment Gates and Approvals Commercial examples/devops/deployment-gates-approvals/
Terraform Pipeline Automation and Best Practices Commercial examples/devops/terraform-pipeline-automation/
Terraform State Management and Backend Configuration Commercial examples/devops/terraform-state-management/
Drift Detection and Remediation Strategies Commercial examples/devops/drift-detection-remediation/
Pipeline Security and Secrets Management Commercial examples/devops/pipeline-security-secrets-management/
Security Topics and Controls for Azure DevOps Commercial examples/devops/security-topics-controls/
Policy as Code Integration Commercial examples/devops/policy-as-code-integration/

📖 Category README

Terraform Examples

All deployable Terraform configurations live under examples/. Each directory maps to one whitepaper or architecture brief. Curated examples are protected by a committed .curated marker file.

# Bootstrap curated examples for security/devops (one-time)
.\scripts\bootstrap-security-devops-examples.ps1

# Mark examples as curated (prevents extract-terraform overwrite)
.\scripts\mark-curated.ps1

# Extract examples from whitepaper markdown (skips .curated directories)
.\scripts\extract-terraform.ps1

# Add stub resources for undeclared references
.\scripts\stub-missing-resources.ps1

# Validate all examples locally
.\scripts\validate-examples.ps1

# Validate INDEX.md matches filesystem
.\scripts\validate-index.ps1

See examples/README.md for details.

Templates & Contributing

Resource Path
Full whitepaper template templates/whitepaper-template.md
Architecture brief template templates/architecture-brief-template.md
Contributing guide CONTRIBUTING.md
Request a whitepaper Issue template

Repository Structure

whitepapers/
├── INDEX.md                 # This file — complete catalog
├── README.md                # Repository entry point
├── CONTRIBUTING.md
├── templates/               # Whitepaper and brief templates
├── examples/                # Deployable Terraform per document
│   ├── architecture/
│   ├── compute/
│   ├── storage/
│   ├── networking/
│   ├── security/
│   └── devops/
├── scripts/                 # extract-terraform, validate, stub, validate-index
├── architecture/
├── compute/
│   └── aks-architecture-briefs/
├── storage/
├── networking/
├── security/
└── devops/