As can be seen here, the documentation is duplicated across src/docs/asciidoc and src/docs/asciidoc/v1, which is not only a burden to maintain, but also runs a high risk of them going out of sync, as shown here.
The solution is to create folder src/docs/asciidoc/common and use AsciiDoc's include directive:
An include directive imports content from a separate file or URL into the content of the current document. When the current document is processed, the include directive syntax is replaced by the contents of the include file. Think of the include directive like a file expander. [Source]
As can be seen here, the documentation is duplicated across
src/docs/asciidoc
andsrc/docs/asciidoc/v1
, which is not only a burden to maintain, but also runs a high risk of them going out of sync, as shown here.The solution is to create folder
src/docs/asciidoc/common
and use AsciiDoc's include directive: