Open ericzolf opened 1 year ago
The documentation no longer lives in this repository, so this is not the proper place to file an issue. If the documentation pertains to the AsciiDoc Language guide, then you can file the issue in the following repository: https://github.com/asciidoctor/asciidoc-docs You may notice there is already an open issue related to this subject. See https://github.com/asciidoctor/asciidoc-docs/issues/79
I'm generally very satisfied with the documentation but how to cross-reference sections is a bit all over the place between anchors, ID generation, cross-reference, etc and difficult to grasp as a whole. As a colleague exactly asked me the same question, I create the following example:
Perhaps a similar documentation could be added to the documentation and the different pieces of the puzzle be put together for newcomers?