> **Page index:** https://km.oslo.systems/llms.txt lists every page on this site, with a link to its Markdown version.

# Architectural decision records

An ADR captures an important architectural decision made along with its context and consequences.

The key motivations for ADRs are

- **Historical context**: It lets stakeholders understand why a decision was made. ADRs makes it easier to change a decision in the future, because it shows the rationale behind a decision.
- **Communication**: Everyone understands why a decision was made.
- **Documentation**: It enables the organization to reference a document rather than explaining a decision over and over again.

For more information, see:

- [The homepage of the ADR GitHub organization](<https://adr.github.io/>).
- [The AWS prescriptive guidance on using ADRs](<https://docs.aws.amazon.com/prescriptive-guidance/latest/architectural-decision-records/adr-process.html>).

## Records

| Date | ADR |
| --- | --- |
| 2023-10-03 | [Updating images in ECS tasks with Terraform](<https://github.com/oslokommune/pirates-iac/blob/main/docs/adr/ecs-task-definition-update.md>) |
| 2023-09-29 | [Use of stacks for organizing infrastructure components](<https://github.com/oslokommune/pirates-iac/blob/main/docs/adr/stack-organization.md>) |
| 2023-09-22 | [Third-party community modules](<https://github.com/oslokommune/pirates-iac/blob/main/docs/adr/third-party-community-modules.md>) |
| 2023-04-12 | [Security groups in separate stack](<https://github.com/oslokommune/pirates-iac/blob/main/docs/adr/security-groups-in-separate-stack.md>) |
| 2023-04-12 | [Structuring many environments](<https://github.com/oslokommune/pirates-iac/blob/main/docs/adr/structuring-multiple-environments.md>) |
| 2023-04-04 | [Dependency discovery](<https://github.com/oslokommune/pirates-iac/blob/main/docs/adr/dependency-discovery.md>) |