[SOLR-13782] Make HTML Ref Guide the primary release vehicle instead of PDF

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Done
• Fix Version/s: 8.4
• Component/s: documentation
• Assignee: Cassandra Targett
• Reporter: Cassandra Targett
• Created: 20/Sep/19 19:57
• Updated: 28/Apr/21 20:28
• Resolved: 19/Nov/19 21:59

Description

As discussed in a recent mail thread [1], we have agreed that it is time for us to stop treating the PDF version of the Ref Guide as the "official" version and instead emphasize the HTML version as the official version.

The arguments for/against this decision are in the linked thread, but for the purpose of this issue there are a couple of things to do:

• Modify the publication process docs (under solr/solr-ref-guide/src/meta-docs
• Announce to the solr-user list that this is happening

A separate issue will be created to automate parts of the publication process, since they require some discussion and possibly coordination with Infra on the options there.

[1] https://lists.apache.org/thread.html/f517b3b74a0a33e5e6fa87e888459fc007decc49d27a4f49822ca2ee@%3Cdev.lucene.apache.org%3E

Issue Links

• is related to: SOLR-15382 Remove PDF compatibility checks from Ref-Guide
• links to: GitHub Pull Request #999