Disable the auto-generation of section IDs ?
- Dominant language
- Ruby
- Stars
- 265
- Forks
- 347
- Avg merge
- 3d 15h
- Merged PRs (30d)
- 2
Description
While reviewing the differences between the old and new (Asciidoctor) output for https://github.com/elastic/docs/pull/666, we noticed that there are a *lot* of autogenerated section IDs. For example:
``
``
Per https://asciidoctor.org/docs/user-manual/#auto-generated-ids, you can disable the auto-generation of section IDs, by unsetting the sectids attribute.
Should we consider doing this? It would mean that if we want to be able to link to a section, we'd have to explicitly add an anchor, which is what we had discussed as a best practice anyway.
If we do want to do this, would then want to consider whether we do it for all books or a subset.
Related to https://github.com/elastic/docs/issues/647
Contributor guide
No contributing guide indexed for this repository
Assessment
This issue has not been assessed yet.