[SOLR-14824] Simplify set of Ref Guide build parameters

• Type: Improvement
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Fix Version/s: 9.0
• Component/s: Build, documentation
• Assignee: Chris M. Hostetter
• Reporter: Cassandra Targett
• Created: 02/Sep/20 19:38
• Updated: 12/May/22 00:26
• Resolved: 18/Sep/20 21:45

Description

While trying to solve LUCENE-9495, I thought it might be a good idea to try to simplify the set of variables and properties used during the Ref Guide build.

There are 3 areas to work on:

1. Remove the "barebones-html" build. With Gradle the build is self-contained and gradlew check and gradle precommit could just build the full docs and check them.

2. Remove some properties that only existed for a hypothetical need related to the now-removed PDF.

3. Change remaining properties to be defined directly in build.gradle instead of relying on ant properties functionality.

Issue Links

• is related to: LUCENE-9495 Ref Guide gradle buildSite ignores version parameter
• is related to: SOLR-14870 gradle build does not validate ref-guide -> javadoc links
• relates to: SOLR-14889 improve templated variable escaping in ref-guide _config.yml