While reviewing the differences between the old and new (Asciidoctor) output for #666, we noticed that there are a lot of autogenerated section IDs. For example:
<a id="_fix_split_brain_can_occur_even_with_minimum_master_nodes_status_done_v1_4_0_beta1">
<a id="_using_lucene_checksums_to_verify_shards_during_snapshot_restore_status_done_v1_3_3">
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 #647
While reviewing the differences between the old and new (Asciidoctor) output for #666, we noticed that there are a lot of autogenerated section IDs. For example:
<a id="_fix_split_brain_can_occur_even_with_minimum_master_nodes_status_done_v1_4_0_beta1"><a id="_using_lucene_checksums_to_verify_shards_during_snapshot_restore_status_done_v1_3_3">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 #647