logo
Forge
Overview
Initializing search
    • Forge
    • Guides
    • Reference
    • Release Notes
    • Foundry
    • About
    • Forge
    • Guides
      • Tutorials
        • Build on Your App
      • Development
        • Aspire Publish
        • Aspire Troubleshooting
        • Blue-Green Deployments
        • Downstream API Calls
        • Custom Subdomains
        • Documentation Site
        • Feature Flags
        • SAIF CLI Installation
        • Pipeline Troubleshooting
        • PR Slot Deployments
        • Settings and Secrets
        • TypeSpec Contracts
        • TypeSpec API Design
          • Cosmos DB NoSQL
          • Oracle Database
          • Blob Storage
          • Event Service
          • Event Subscriptions
          • WireMock Hosting
          • WireMock Runner Hosting
          • WireMock Recording
          • API Testing with Aspire
          • Integration Test Environment Variables
          • Web Testing with Playwright
        • Webhooks
          • Filevine Webhook Integration
      • Migration
        • Forge v1 to v2
        • Forge v2 to v3
        • Test Tools Migration (Forge v2 to v3)
        • MCP-Assisted Migration to Forge v3
        • Migrate to saif-business-roles
      • Security
          • App Permissions
          • Aspire Security Configuration
          • Business Roles
          • Deployment Workflow
          • Subscription Key Authentication
          • User Permissions
          • JWT Test Tokens
          • Test Tools Repository
          • External Test Users
          • Non-Production Roles
    • Reference
      • Authorization
      • Environments
      • How Authentication Works
      • Pipelines
      • Service ↔ Azure Resource Model
      • Version Compatibility Matrix
      • Architecture
        • Golden Path
      • Decisions
        • Use Markdown Architectural Decision Records
        • Terraform State and Module Management
        • All API Endpoints Require Authentication
        • All Non-Api Management Azure Resources Will Have Private Endpoints
        • Preferred Method of Deployment of APIs
        • Subdomain Names of Applications and APIs
        • Okta Multi-Tenant Architecture
        • Observability and Monitoring
        • Terraform Linting
        • On-Premise Authentication to Forge Applications
        • Feature Flag Provider Selection
        • Shared Platform SDK and Tiered Documentation Search
      • Diagnostics
        • SAIFENV001: SAIF Environment API is Experimental
        • SAIFMOCK001: WireMock Runner API is Experimental
        • SAIFSECURITY001: Security Configuration API is Experimental
      • Tools
        • Aspire
        • Azure
        • Azure DevOps Services
        • Docker Desktop
        • Dynatrace
        • Entity Framework
        • Kiota
        • OpenTelemetry
        • Project Templates
        • SAIF CLI
        • Terraform
        • Terraform Cloud
        • TypeSpec
        • WireMock
    • Release Notes
      • 3.8.2
      • 3.8.1
      • 3.8.0
      • 3.7.5
      • 3.7.4
      • 3.7.3
      • 3.7.2
      • 3.7.1
      • 3.7.0
      • 3.6.7
      • 3.6.6
      • 3.6.5
      • 3.6.4
      • 3.6.3
      • 3.6.2
      • 3.6.1
      • 3.6.0
      • 3.5.2
      • 3.5.0
      • 3.4.0
      • 3.3.0
      • 3.2.7
      • 3.2.6
      • 3.2.5
      • 3.2.4
      • 3.2.3
      • 3.2.2
      • 3.2.1
      • 3.2.0
      • 3.1.3
      • 3.1.2
      • 3.1.1
      • 3.1.0
      • 3.0.14
      • 3.0.13
      • 3.0.12
      • 3.0.11
      • 3.0.10
      • 3.0.9
      • 3.0.8
      • 3.0.7
      • 3.0.6
      • 3.0.5
      • 3.0.4
      • 3.0.3
      • 3.0.2
      • 3.0.1
      • 3.0.0
      • 2.1.25
      • 2.1.24
      • 2.1.23
      • 2.1.22
      • 2.1.21
      • 2.1.20
      • 2.1.19
      • 2.1.18
      • 2.1.17
      • 2.1.16
    • Foundry
        • Blob Storage Integration
        • Aspire Configuration Example
        • Playwright Integration Testing
        • WireMock CLI Example
        • WireMock Runner Example
        • DevTunnels Webhook Example
        • Event Orchestration Example
        • Events with Cosmos DB Example
        • APIM Policy Example
    • About
      • Platform Overview
      • History
      • Principles
      • Technology Vision
      • Contributing
        • GitHub Copilot Configuration
        • Design System
        • Forge Monorepo
        • SAIF DotNet CLI Project Templates
        • Release Process
        • MSBuild Reference Swapping
        • Terraform Module Swapping
        • Local Terraform Testing
        • Terraform Repository Inventory
        • Update-ForgePackageConfig.ps1

    Architectural Decision Records¶

    Architectural Decision Records (ADRs) capture significant technical and architectural choices made for this platform. Use this section to browse past decisions, understand their context, and ensure new work aligns with established direction.

    • 0000-use-markdown-architectural-decision-records
    • 0001-terraform-state-and-module-management
    • 0002-all-api-endpoints-require-authentication
    • 0003-all-non-api-management-azure-resources-will-have-private-endpoints
    • 0004-preferred-method-of-deployment-of-apis
    • 0005-subdomain-names-of-applications-and-apis
    • 0006-okta-multi-tenant-architecture
    • 0007-observability-and-monitoring
    • 0008-terraform-linting
    • 0009-on-premise-authentication-to-forge
    • 0010-feature-flag-provider-selection
    • 0011-shared-platform-sdk-and-tiered-documentation-search
    June 22, 2026
    Made with Material for MkDocs