Next steps and resources - AWS Prescriptive Guidance

Next steps and resources

We recommend that you start small and see the benefit that ADRs bring to your team. If you are working on an ongoing project, identify the next architectural change and apply the proposed ADR process to create your first ADR.

Another starting point is to document your overall software development process by using ADRs. Often, the development process is based on tacit knowledge that the team didn’t capture in any documentation. Documenting this process enables a smoother experience for new members of the team.

If you are on a greenfield project, apply the ADR process and start capturing all the decisions from the beginning in a few sentences. You can then iterate on those ADRs and supplement them with new information. After you establish your ADRs, you can start using them as a reference in your code review process.