[SOLR-12786] Upgrade refGuide build to Asciidoctor 2.0.10 and new link structure

• Type: Improvement
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 8.0
• Fix Version/s: 8.3
• Component/s: Build, documentation
• Assignee: Cassandra Targett
• Reporter: Jan Høydahl
• Created: 20/Sep/18 12:44
• Updated: 07/Nov/19 21:22
• Resolved: 16/Oct/19 20:25

Description

Currently the refguide build requires asciidoctor 1.5.6.2.

People using gem install jekyll-asciidoc will end up with version 1.5.7, causing different header ID syntax and the build will break.

Long term we should move to latest asciidoctor.

It is already documented in README how to install the older 1.5.6.2 version.

 

Issue Links

• links to: GitHub Pull Request #952