[ https://issues.apache.org/jira/browse/SOLR-11050?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16085329#comment-16085329 ]
Jan Høydahl commented on SOLR-11050: ------------------------------------ Great idea, much cleaner AsciiDoc and nice to do this before people start spreading too many links around. Should we add a note to {{meta-docs/asciidoc-syntax.adoc}} about the difference between implicit section achors and explicit ones, and that if you rename a section heading, you should add an explicit anchor not to break existing deep-links? Example: {code} == This is a heading Bla bla {code} can be linked to using {{#this-is-a-heading}} if you rename the heading to something else, you could do so without changing the anchor: {code} [[this-is-a-heading]] == This is a changed heading Bla bla {code} > Ref Guide: Remove Confluence-style anchor refs & clean up duplicate section > titles > ---------------------------------------------------------------------------------- > > Key: SOLR-11050 > URL: https://issues.apache.org/jira/browse/SOLR-11050 > Project: Solr > Issue Type: Task > Security Level: Public(Default Security Level. Issues are Public) > Components: documentation > Reporter: Cassandra Targett > Assignee: Cassandra Targett > Fix For: 7.0 > > > To ensure section and page title uniqueness during conversion, we retained > Confluence-style anchor references in the new .adoc files, which lead to long > links and confusion about how to construct a link to another page/section. It > was always the intention to remove these, but we didn't do it during the > initial post-conversion cleanup and I neglected to file an issue for it. > A script for this has been suggested, but that's problematic because many > section titles are repeated on different pages (like "Input", etc.), and > someone needs to decide how to modify the section titles to ensure clarity > and uniqueness at the same time. Otherwise, Ref Guide builds will fail. -- This message was sent by Atlassian JIRA (v6.4.14#64029) --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@lucene.apache.org For additional commands, e-mail: dev-h...@lucene.apache.org