Find out how to use/include an adoc document in different repositories

[zrgt]

There are some parts in documents which are the same (e.g. "Terms, Definitions and Abbreviations"). The question is: how we can create and maintain these parts in one single repo and use it across all documents. Please find out.

[monsieuremre]

Possible to link. So it should be possible to include as well. This may bring about other issues tho.

If the preamble section is included from another module, then when viewing the documentation repository on its own, on not the final complete website, this include would not resolve, since the module on its own cannot access other modules when not compiled as a part of a bigger site.

So including parts would mean: single parts cannot be converted to html and pdf files on their own.

I also do not see much benefit that would outweight these small problems. Also, implementation may actually be not that straightforward.

But if we were to insist on going this path, I would suggest we create a new module that would host the shared content.

Please Note: Referencing is trivial, but including might not be that trivial. It was just my initial guess that it should be similar.