Can ADRs be written in AsciiDoc format?

[synclpz]

Description

At the moment of issue creation the file https://github.com/structurizr/structurizr.github.io/blob/b59cba34418cb2298ed0e9b8b5e52b3c9de4b0fb/ui/decisions/index.md contains line

In Structurizr, each ADR has an ID, title, date and status (e.g. "Proposed", "Accepted", "Superseded", etc), along with unstructured content written using Markdown or AsciiDoc. ADRs can either be created manually, or imported from tools like [adr-tools](https://github.com/npryce/adr-tools).

This line should be changed to

In Structurizr, each ADR has an ID, title, date and status (e.g. "Proposed", "Accepted", "Superseded", etc), along with unstructured content written using Markdown. ADRs can either be created manually, or imported from tools like [adr-tools](https://github.com/npryce/adr-tools).

According to https://github.com/structurizr/structurizr.github.io/blob/main/dsl/adrs.md and source for parser https://github.com/structurizr/import/blob/595fa3dfe26dc38803b1adcb0caf4052762e0fc6/src/main/java/com/structurizr/importer/documentation/AdrToolsDecisionImporter.java the only way is to use .md

Steps to reproduce

Open doc at https://github.com/structurizr/structurizr.github.io/blob/b59cba34418cb2298ed0e9b8b5e52b3c9de4b0fb/ui/decisions/index.md or https://docs.structurizr.com/ui/decisions/.

Screenshot

No response

Code sample

No response

Configuration

No response

Severity

Minor

Priority

I have no budget and there's no rush, please fix this for free

More information

No response

[synclpz]

BTW adrs doc also has a reference to AsciiDoc support at https://github.com/structurizr/structurizr.github.io/blob/b59cba34418cb2298ed0e9b8b5e52b3c9de4b0fb/dsl/adrs.md#L11C44-L11C44

[simonbrowndotje]

AsciiDoc decisions can be rendered by the Structurizr UI:

As it says at https://docs.structurizr.com/dsl/adrs:

The above behaviour can be customised by specifying the fully qualified class name of your own implementation of DocumentationImporter, which needs to be on the DSL classpath or installed as a JAR file in the plugins directory next to your DSL file.

As far as I'm aware though, nobody has yet written (or released publicly) an importer for AsciiDoc ADRs.

[synclpz]

I've just written one, actually extended yours (it now just works for both Markdown & AsciiDoc). I can share at as a PR if you wish to have it in your codebase. For us it works as a plugin in workspace now.

[synclpz]

@simonbrowndotje do you need a universal (md+asciidoc) ADR importer to be included in your DSL repo? I can make a PR, I got code and tests ready. For me it would be great if it could come with structurizr itself and not as a plugin.