[jira] [Resolved] (SOLR-11050) Ref Guide: Remove Confluence-style anchor refs & clean up duplicate section titles

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
1 message Options
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

[jira] [Resolved] (SOLR-11050) Ref Guide: Remove Confluence-style anchor refs & clean up duplicate section titles

JIRA jira@apache.org

     [ https://issues.apache.org/jira/browse/SOLR-11050?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Cassandra Targett resolved SOLR-11050.
--------------------------------------
    Resolution: Fixed

There may be one or two stragglers left over, but I'm confident I've eradicated 99.9% of the anchors inserted by the conversion process.

> 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: [hidden email]
For additional commands, e-mail: [hidden email]

Loading...