# Reference Documentation

This section contains reference materials, technical specifications, and conceptual documentation for the Forge platform.

## 📚 Reference Categories

- [🏗️ Architecture](architecture/index.md) - Platform structure, the Golden Path, and authentication mechanics
- [📋 Decisions](decisions/index.md) - Accepted architectural and convention decisions
- [🧰 CLI commands](dotnet/SAIF.Platform.CLI/commands.md) - Generated command syntax and options
- [🧭 CLI workflows](cli-workflows.md) - Authentication, publishing, search, and operational constraints
- [🤖 Smithy](smithy.md) - Shared assistant and MCP contract
- [📦 Terraform Modules](terraform/index.md) - Generated module reference from source READMEs
- [🧾 @saif/platform-typespec](./platform-typespec.md) - Operation templates, status-code models, auth helpers, and eventing contracts for API contracts
- [📦 .NET Packages](./dotnet/index.md) - Generated reference documentation for Forge's .NET packages, sourced from each package's `README.md` under `src/dotnet/`
- [📦 TypeScript Packages](./typescript/index.md) - Generated reference documentation for Forge's TypeScript packages, sourced from each package's `README.md` under `src/typescript/packages/`
- [📊 Version Compatibility Matrix](./version-compatibility.md) - Framework versions, breaking changes, and migration guides
- [🌍 Environments](./environments.md) - Environment configurations, deployment flows, and approvers
- [🚀 Pipelines](./pipelines.md) - What each `.azdo` pipeline does, what triggers it, and which one to run
- [🔎 Read pipeline logs](pipeline-log-reading.md) - Log selection, filters, and cross-job investigation
- [🧭 Service ↔ Azure Resource Model](./service-azure-resource-model.md) - How a service maps to live Azure resources: naming invariant, subscription topology, resource discovery, and tag contract
- [🔐 Security](./authorization.md) - Authentication, authorization, and security patterns
- [📝 Documentation Authoring](./documentation-authoring.md) - Answer-first troubleshooting page shape, metadata, and validation guidance
- [🔎 Documentation Retrieval](./documentation-retrieval.md) - Provider chain, multi-site MkDocs fallback, location resolution rules, AI Search filter contract, and the evaluation harness
- [🏷️ Tags](tags.md) - Browse documentation by component and topic