# Architectural decision records

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

They 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){:target="_blank"}    |
| 2023-09-29 | [Use of stacks for organizing infrastructure components](https://github.com/oslokommune/pirates-iac/blob/main/docs/adr/stack-organization.md){:target="_blank"} |
| 2023-09-22 | [Third-party community modules](https://github.com/oslokommune/pirates-iac/blob/main/docs/adr/third-party-community-modules.md){:target="_blank"}               |
| 2023-04-12 | [Security groups in separate stack](https://github.com/oslokommune/pirates-iac/blob/main/docs/adr/security-groups-in-separate-stack.md){:target="_blank"}       |
| 2023-04-12 | [Structuring many environments](https://github.com/oslokommune/pirates-iac/blob/main/docs/adr/structuring-multiple-environments.md){:target="_blank"}           |
| 2023-04-04 | [Dependency discovery](https://github.com/oslokommune/pirates-iac/blob/main/docs/adr/dependency-discovery.md){:target="_blank"}                                 |