[jira] [Commented] (SOLR-11050) Ref Guide: Remove Confluence-style anchor refs & clean up duplicate section titles
[ https://issues.apache.org/jira/browse/SOLR-11050?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16088130#comment-16088130 ] ASF subversion and git services commented on SOLR-11050: Commit ec5af29df18b3729689e2a2f5748f82c74416797 in lucene-solr's branch refs/heads/branch_7x from [~ctargett] [ https://git-wip-us.apache.org/repos/asf?p=lucene-solr.git;h=ec5af29 ] SOLR-11050, SOLR-10892: last set of Confluence-style anchors removed and parameter tables obliterated > 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
[jira] [Commented] (SOLR-11050) Ref Guide: Remove Confluence-style anchor refs & clean up duplicate section titles
[ https://issues.apache.org/jira/browse/SOLR-11050?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16088132#comment-16088132 ] ASF subversion and git services commented on SOLR-11050: Commit 74a526b4d984d2c670c43b33fa3aabe2aa62465e in lucene-solr's branch refs/heads/branch_7_0 from [~ctargett] [ https://git-wip-us.apache.org/repos/asf?p=lucene-solr.git;h=74a526b ] SOLR-11050, SOLR-10892: last set of Confluence-style anchors removed and parameter tables obliterated > 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
[jira] [Commented] (SOLR-11050) Ref Guide: Remove Confluence-style anchor refs & clean up duplicate section titles
[ https://issues.apache.org/jira/browse/SOLR-11050?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16088120#comment-16088120 ] ASF subversion and git services commented on SOLR-11050: Commit bbae31b9d22d0f96810edbbe8898bb3016f0c253 in lucene-solr's branch refs/heads/master from [~ctargett] [ https://git-wip-us.apache.org/repos/asf?p=lucene-solr.git;h=bbae31b ] SOLR-11050, SOLR-10892: last set of Confluence-style anchors removed and parameter tables obliterated > 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
[jira] [Commented] (SOLR-11050) Ref Guide: Remove Confluence-style anchor refs & clean up duplicate section titles
[ https://issues.apache.org/jira/browse/SOLR-11050?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16087753#comment-16087753 ] ASF subversion and git services commented on SOLR-11050: Commit 333906f8285dd7d589fde563a6bbea64d7059ac5 in lucene-solr's branch refs/heads/branch_7_0 from [~ctargett] [ https://git-wip-us.apache.org/repos/asf?p=lucene-solr.git;h=333906f ] SOLR-11050: remove unneeded anchors for pages that have no incoming links from other pages > 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
[jira] [Commented] (SOLR-11050) Ref Guide: Remove Confluence-style anchor refs & clean up duplicate section titles
[ https://issues.apache.org/jira/browse/SOLR-11050?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16087755#comment-16087755 ] ASF subversion and git services commented on SOLR-11050: Commit 80a8829b486ea5665e79808f2cd7e4a90b6b2570 in lucene-solr's branch refs/heads/branch_7_0 from [~ctargett] [ https://git-wip-us.apache.org/repos/asf?p=lucene-solr.git;h=80a8829 ] SOLR-11050: update asciidoc-syntax.adoc meta-docs for how to make links > 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
[jira] [Commented] (SOLR-11050) Ref Guide: Remove Confluence-style anchor refs & clean up duplicate section titles
[ https://issues.apache.org/jira/browse/SOLR-11050?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16087754#comment-16087754 ] ASF subversion and git services commented on SOLR-11050: Commit c6771499630bc72da1a6b2688597083be366d7ca in lucene-solr's branch refs/heads/branch_7_0 from [~ctargett] [ https://git-wip-us.apache.org/repos/asf?p=lucene-solr.git;h=c677149 ] SOLR-11050: remove Confluence-style anchors and fix all incoming links > 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
[jira] [Commented] (SOLR-11050) Ref Guide: Remove Confluence-style anchor refs & clean up duplicate section titles
[ https://issues.apache.org/jira/browse/SOLR-11050?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16087742#comment-16087742 ] ASF subversion and git services commented on SOLR-11050: Commit b46146b234b66dd06f18c69f9729ff0b35f23f08 in lucene-solr's branch refs/heads/branch_7x from [~ctargett] [ https://git-wip-us.apache.org/repos/asf?p=lucene-solr.git;h=b46146b ] SOLR-11050: remove unneeded anchors for pages that have no incoming links from other pages > 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
[jira] [Commented] (SOLR-11050) Ref Guide: Remove Confluence-style anchor refs & clean up duplicate section titles
[ https://issues.apache.org/jira/browse/SOLR-11050?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16087741#comment-16087741 ] ASF subversion and git services commented on SOLR-11050: Commit c0c0bdedbe827668bbdae975b05fa34fe8350a26 in lucene-solr's branch refs/heads/branch_7x from [~ctargett] [ https://git-wip-us.apache.org/repos/asf?p=lucene-solr.git;h=c0c0bde ] SOLR-11050: remove Confluence-style anchors and fix all incoming links > 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
[jira] [Commented] (SOLR-11050) Ref Guide: Remove Confluence-style anchor refs & clean up duplicate section titles
[ https://issues.apache.org/jira/browse/SOLR-11050?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16087740#comment-16087740 ] ASF subversion and git services commented on SOLR-11050: Commit 75d8d0bb6d6ff9f7ec421293b8a4cc4b1a8bbb36 in lucene-solr's branch refs/heads/branch_7x from [~ctargett] [ https://git-wip-us.apache.org/repos/asf?p=lucene-solr.git;h=75d8d0b ] SOLR-11050: update asciidoc-syntax.adoc meta-docs for how to make links > 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
[jira] [Commented] (SOLR-11050) Ref Guide: Remove Confluence-style anchor refs & clean up duplicate section titles
[ https://issues.apache.org/jira/browse/SOLR-11050?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16086473#comment-16086473 ] Jan Høydahl commented on SOLR-11050: bq. There are also other ways to deal with the problem of a dead reference - a helpful 404 page or actual search Yea, renaming of a page is worse than renaming an anchor, which would still land you on top of that page. It would be cool if our 404 page gave, say, three suggestions for pages that match the file-name that do not exist. > 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
[jira] [Commented] (SOLR-11050) Ref Guide: Remove Confluence-style anchor refs & clean up duplicate section titles
[
https://issues.apache.org/jira/browse/SOLR-11050?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16086174#comment-16086174
]
Cassandra Targett commented on SOLR-11050:
--
I just pushed a number of edits to {{asciidoc-syntax.adoc}} about link
construction, to make it much more clear how to construct such links. I decided
this was needed yesterday while working through the links, because I learned
much more about the differences during the process than I knew before and I
also knew the section was pretty light on info to start with.
bq. 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
I didn't add this. It's already a bit fraught when you try to come up with a
simple answer to the question "How do I make a link to a section of another
page?" - I didn't want to add a decision tree to the equation. My goal in all
of this is to make it simpler for anyone with an ounce of energy to help with
the writing part.
I'm not saying I disagree with a policy of trying to keep links from being
dead, but I think there are some "well, maybe not always..." situations - I
don't want to have to carry around refs to section titles from 15 releases ago
because someone maybe has a bookmark to it. There are cases where we need to
just rename it and fix any incoming references and move on. There are also
other ways to deal with the problem of a dead reference - a helpful 404 page or
actual search, to name a couple - that we should explore, which IMO are beyond
the scope of this cleanup issue.
> 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
[jira] [Commented] (SOLR-11050) Ref Guide: Remove Confluence-style anchor refs & clean up duplicate section titles
[ https://issues.apache.org/jira/browse/SOLR-11050?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16086140#comment-16086140 ] ASF subversion and git services commented on SOLR-11050: Commit 801a44ca163c5fb2eb62ff3e943923b9965d7bc7 in lucene-solr's branch refs/heads/master from [~ctargett] [ https://git-wip-us.apache.org/repos/asf?p=lucene-solr.git;h=801a44c ] SOLR-11050: update asciidoc-syntax.adoc meta-docs for how to make links > 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
[jira] [Commented] (SOLR-11050) Ref Guide: Remove Confluence-style anchor refs & clean up duplicate section titles
[
https://issues.apache.org/jira/browse/SOLR-11050?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=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
[jira] [Commented] (SOLR-11050) Ref Guide: Remove Confluence-style anchor refs & clean up duplicate section titles
[ https://issues.apache.org/jira/browse/SOLR-11050?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16085007#comment-16085007 ] ASF subversion and git services commented on SOLR-11050: Commit 8b65515f073e6b9de063fda2df775dc8595339c1 in lucene-solr's branch refs/heads/master from [~ctargett] [ https://git-wip-us.apache.org/repos/asf?p=lucene-solr.git;h=8b65515 ] SOLR-11050: remove Confluence-style anchors and fix all incoming links > 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
[jira] [Commented] (SOLR-11050) Ref Guide: Remove Confluence-style anchor refs & clean up duplicate section titles
[ https://issues.apache.org/jira/browse/SOLR-11050?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16085006#comment-16085006 ] ASF subversion and git services commented on SOLR-11050: Commit 74ab16168c8a988e5190cc6e032039c43a262f0e in lucene-solr's branch refs/heads/master from [~ctargett] [ https://git-wip-us.apache.org/repos/asf?p=lucene-solr.git;h=74ab161 ] SOLR-11050: remove unneeded anchors for pages that have no incoming links from other pages > 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
