[
https://issues.apache.org/jira/browse/SOLR-14444?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17368402#comment-17368402
]
Cassandra Targett commented on SOLR-14444:
------------------------------------------
I've prepared a pull request to merge this work into {{main}}:
https://github.com/apache/solr/pull/190
I did not move any of the SolrCloud content around - I started to, and then
decided to take Jan's suggestion to push forward with what I already had and
come back to it later.
I kept track of the page renames and removals in a Google spreadsheet:
https://docs.google.com/spreadsheets/d/1mwxSpn5Ky7-P4DLFrJGel2h7Il4muTlHmAA-AuRY1rs.
* Yellow rows are removals; notes reference what happened to the content.
* Reddish-filled cells are pages which are primarily navigational.
* Gray rows were removed by the project during the time I was working on this.
* Renames are in the 2nd column where applicable.
(Other tabs in the sheet were for my reference as I worked through this
project).
You can view the new Ref Guide here:
https://people.apache.org/~ctargett/experiments/RefGuideReOrg/. This is
protected by a username and password to keep it out of Google, use {{apache}}
and {{solr}} to access it.
There is more to do but it can be tackled after merging (these might all need
to be sub-tasks or other jiras):
* Complete moving all sentences to begin on new lines (this makes merging other
changes from the project really difficult so I've held off doing it everywhere).
* Complete introduction of new format for parameters.
* Update ref guide links in all config files and READMEs
* Figure out what we want to do about redirects from old page urls to new urls.
> Ref Guide Redesign Phase 2: Page Organization Overhaul
> ------------------------------------------------------
>
> Key: SOLR-14444
> URL: https://issues.apache.org/jira/browse/SOLR-14444
> Project: Solr
> Issue Type: Improvement
> Components: documentation
> Reporter: Cassandra Targett
> Assignee: Cassandra Targett
> Priority: Major
> Fix For: main (9.0)
>
> Time Spent: 10m
> Remaining Estimate: 0h
>
> SOLR-14173 changed the look & feel of the Ref Guide, and left one glaring
> problem unresolved: our top-level categories are far too many for that sort
> of design.
> This issue will track a full reconsideration of the Ref Guide organization. I
> have a couple of thoughts and will update this issue with those when I get
> started on it; for now this is a placeholder issue for future work.
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscr...@solr.apache.org
For additional commands, e-mail: issues-h...@solr.apache.org
