Consolidate and clarify anchors and ID end user documentation
The end user documentation regarding anchors and IDs needs to be consolidated and clarified as some users have expressed that the concepts of ID and anchor could be better explained, that the information about where IDs can be placed and the syntax for such use cases should be consolidated, and that more and/or better examples would be helpful.
This issue should:
- identify what areas of the anchor and ID end user documentation needs to be clarified (restructured, reworked, more search-friendly, direct headings, etc.)
- restructure and edit the anchor and ID content that is problematic
- make sure that the exceptions and recommendations for each syntax and/or use case is clearly stated
- add new content and/or new examples for any anchor and ID use cases
This issue was created based on a PR and the discussion referenced in the PR: https://github.com/asciidoctor/asciidoc-docs/pull/106
This issue may have some cross over with #19.