Missing documentation on AsciiDoc integration

Everyone can contribute. Help move this issue forward while earning points, leveling up and collecting rewards.

• Close this issue

Problem to solve

There is no documentation on AsciiDoc integration (not to confuse with syntax reference which exists).

Compare with e.g. Kroki: https://docs.gitlab.com/ee/administration/integration/kroki.html

Further details

This is issue came up because the GitLab AsciiDoc integration does not allow URI includes (allow-uri-read is not activated). We have a self-hosted GitLab that we would like to activate URI includes for. It is not clear for us how to do it.

The GitLab documentation https://docs.gitlab.com/ee/user/asciidoc.html#includes states:

// define -a allow-uri-read to allow content to be read from URI
include::https://example.org/installation.adoc[]

But, there is no documentation how to actually activate it.

Proposal

Add documentation on GitLab's integration with AsciiDoc.

Who can address the issue

Other links/references