I looked for a tool to create Architecture Decision Records in AsciiDoc and does not find any. So first I thought, I would have to (re)implement one. But look, how easy it really was.
Usually adr-tools create Markdown format, but my idea was to write an Asciidoc template instead.
So first you have to install adr-tools. I use the variant "Git for Windows: git bash".
In the target directory of the adr-tools do the following:
rename both *.md files to *.adoc
change the content of these both files to AsciiDoc, which simple means replace all occurrences of "#" with "="
change other content according to your needs
replace all occurrences of ".md" with ".adoc"
Then you can test this:
$ adr init doc/adr doc/adr/0001-record-architecture-decisions.adoc $ adr new Change File Format of Architecture Decision Records to AsciiDoc doc/adr/0002-change-file-format-of-architecture-decision-records-to-asciidoc.adoc $ cat doc/adr/0002-change-file-format-of-architecture-decision-records-to-asciidoc.adoc = 2. Change File Format of Architecture Decision Records to AsciiDoc Date: 2022-02-15 == Status Accepted == Context The issue motivating this decision, and any context that influences or constrains the decision. == Decision The change that were proposing or have agreed to implement. == Consequences What becomes easier or more difficult to do and any risks introduced by the change that will need to be mitigated.
After that you have to fill the new file with relevant content for your Architecture Decision.