[ https://issues.apache.org/jira/browse/SOLR-10842?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Cassandra Targett updated SOLR-10842: ------------------------------------- Attachment: SOLR-10842.patch Here is a WIP patch for the changes I'm looking at so far if anyone is curious. It moves a lot of stuff around and there is still a lot TODO yet. This patch: * Adds the Solr Tutorial as {{solr-quick-start.adoc}} and as a top-level section, directly under "About this Guide" in the page hierarchy. * Reorganizes the sections under "Getting Started": ** Removes {{a-step-closer.adoc}} from that hierarchy (but it is not entirely removed yet) ** Moves "Taking Solr to Production", "Upgrading a Solr Cluster", and "Upgrading Solr" to the Getting Started section (the first 2 were under "Managing Solr", the last was a top-level section) ** Moves pages in this section around a little bit * Adds two new pages: ** {{solr-system-requirements.adoc}} as an overview of Solr's installation requirements ** {{solr-configuration-files.adoc}} as an overview of Solr Home and relevant Solr config files * Removes some redundant content that appeared on several pages * Moves {{solr-control-script-reference.adoc}} to become a top-level section that comes after "Getting Started" in the page hierarchy. Known TODOs (not including some minor notes in the files already): * Remove {{a-step-closer.adoc}} entirely * Consider renaming "Getting Started" to <something-I-haven't-decided yet> ** Finalize the page depending on its name * Flesh out system requirements information * Rename "Upgrading Solr" to "Solr Upgrade Notes" or something similar to indicate it's not "how to upgrade Solr" * Fix the Solr Tutorial ** It's broken already today because of javadoc changes in SOLR-10862 ** Possibly break it up a bit into smaller bits depending on amount of time user has I may also add more to the TODO list as I continue to work through the pages. > Move quickstart.html to Ref Guide > --------------------------------- > > Key: SOLR-10842 > URL: https://issues.apache.org/jira/browse/SOLR-10842 > Project: Solr > Issue Type: Improvement > Security Level: Public(Default Security Level. Issues are Public) > Components: documentation > Reporter: Cassandra Targett > Assignee: Cassandra Targett > Priority: Minor > Fix For: master (7.0) > > Attachments: SOLR-10842.patch > > > The Solr Quick Start at https://lucene.apache.org/solr/quickstart.html has > been problematic to keep up to date - until Ishan just updated it yesterday > for 6.6, it said "6.2.1", so hadn't been updated for several releases. > Now that the Ref Guide is in AsciiDoc format, we can easily use variables for > package versions, and it could be released as part of the Ref Guide and kept > up to date. It could also integrate links to more information on topics, and > users would already be IN the docs, so they would not need to wonder where > the docs are. > There are a few places on the site that will need to be updated to point to > the new location, but I can also put a redirect rule into .htaccess so people > are redirected to the new location if there are other links "in the wild" > that we cannot control. This allows it to be versioned also, if that becomes > necessary. > As part of this, I would like to also update the entire "Getting Started" > section of the Ref Guide, which is effectively identical to what was in the > first release of the Ref Guide back in 2009 for Solr 1.4 and is in serious > need of reconsideration. > My thought is that moving the page + redoing the Getting Started section > would be for 7.0, but if folks are excited about this idea I could move the > page for 6.6 and hold off redoing the larger section until 7.0. -- 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