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
adrand select it from the editor suggestions (may need to show suggestions withCTRL + spaceorcommand + 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.