DGOV DTT Architecture Decision Records

Architecture records and current decision state to support infrastructure and platform operations for Office of Digital Government (DGOV) Digital Transformation and Technology Unit (DTT).

Supporting training material is available at the DGOV Technical - DevSecOps Induction (guided by the WA Cyber Security Policy).

The Architecture Principles guide all decisions documented here.

Structure

This project uses mdBook to generate documentation from markdown files:

• ADRs are organized in directories by domain (development/, operations/, security/)
• Navigation is defined in SUMMARY.md
• Build output goes to book/ directory

Quick Start

just setup    # One-time setup
just serve    # Preview locally (port 8080)

Run just to see all available commands.

View as PDF | Browse online

Development

First time setup requires installing tools - run just setup for automated installation.

Contributing

New ADRs follow a structured format documenting the context (problem), decision (solution), and consequences (risks).

1. Create new markdown file in appropriate directory (e.g., security/019-new-topic.md)
2. Add entry to SUMMARY.md in the correct section
3. Follow the ADR template structure

See the Contributing Guide for complete workflow and quality standards.