[SOLR-15941] Wire Antora refGuide into the release scripts

• Type: Task
• Status: Closed
• Priority: Blocker
• Resolution: Implemented
• Fix Version/s: 9.0
• Component/s: documentation
• Assignee: Houston Putman
• Reporter: Jan Høydahl
• Created: 20/Jan/22 18:29
• Updated: 12/May/22 00:35
• Resolved: 28/Apr/22 00:42

Description

Current tasks to build and push ref-guide is in https://github.com/apache/solr/blob/main/dev-tools/scripts/releaseWizard.yaml#L1023:L1102

./gradlew solr:solr-ref-guide:buildSite -PsolrGuideDraft=false
svn -m "Add Solr Ref Guide {{ release_version }}" import {{ git_checkout_folder }}/solr/solr-ref-guide/build/html-site  https://svn.apache.org/repos/infra/sites/solr/guide/{{ release_version_refguide }}

This task is to replace those with the commands needed to build the Antora guide (without watermark) and push it. A difference is that we will push the entire tree every time, e.g. to ...guide/solr, and then all versions 9_0 etc are below there.

There is also a task in the wizard for bugfix releases, to overwrite an existing version in svn, doing some svn delete on files removed. In the new system, we'll in reality overwrite all versions for every release, so perhaps we need a similar approach?

Issue Links

• incorporates: SOLR-15557 Figure out how to handle ref guide page renames/redirects
• is blocked by: SOLR-15556 Ref Guide Redesign Phase 3: Replace Jekyll
• links to: GitHub Pull Request #76
• links to: GitHub Pull Request #813

Sub-Tasks

• Add prerelease version to non-released branches for ref-guide: Closed