For new ADRs, the status should be Proposed
. Use one of the following methods to automatically generate a markdown document for the ADR.
- Install
adr-tools
- Run
adr new <title of new ADR as it should appear in documentation>
- Open the new file that was generated in this directory
- Update the placeholder text in the new file to provide information for all required fields
- Create a new markdown file in this directory. The file should follow the naming format
NNNN-lowercase-title-with-dashes.md
- Open the file in a VSCode editor
- Type
adr
and select it from the editor suggestions (may need to show suggestions withCTRL + space
orcommand + space
) - Use tab to navigate through the fields requiring input and update the placeholder text
Follow the steps outlined in CONTRIBUTING.md to create a pull request that adds the new ADR file to the repository.