[SOLR-5965] Solr Reference Guide: Investigate shortcut links to automatically version javadoc links

• Type: Improvement
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Fix Version/s: 4.8
• Component/s: documentation
• Assignee: Steven Rowe
• Reporter: Steven Rowe
• Created: 05/Apr/14 00:30
• Updated: 27/Apr/14 23:25
• Resolved: 16/Apr/14 18:47

Description

Confluence has a feature called "Shortcut links", that allow link prefixes (or infixes or suffixes) to be specified in short form.

I think this feature could be used to version javadoc links so that we have two shortcuts, one for the latest Solr javadocs and another for the latest Lucene javadocs, and then all javadoc links are specified relative to these shortcuts.

See https://confluence.atlassian.com/display/CONF50/Configuring+Shortcut+Links.

Two problems, both minor I think:

1. Creating and maintaining shortcut links requires Confluence Admin privileges, but Apache Infrastructure has taken these away from just about everybody. When I last chatted on #asfinfra with gmcdonald (who took away the privileges), though, he was okay with giving this back Confluence Admin privileges if we found that it was necessary.
2. There is an open bug with editing shortcut-form links - it doesn't work - you have to remove them and then re-add them: https://jira.atlassian.com/browse/CONF-24812