PICARD-1899: Update documentation links

Point to picard-docs.metabrainz.org, consider app version

Author: phw

README.md

@@ -16,7 +16,7 @@ Binary downloads are available [here](http://picard.musicbrainz.org/downloads/).
 Support and issue reporting
 ---------------------------
 
-Please report all bugs and feature requests in the [MusicBrainz issue tracker](https://tickets.metabrainz.org/browse/PICARD). If you need support in using Picard please read the [documentation](https://picard.musicbrainz.org/docs/) first and have a look at the [MusicBrainz community forums](https://community.metabrainz.org/c/picard).
+Please report all bugs and feature requests in the [MusicBrainz issue tracker](https://tickets.metabrainz.org/browse/PICARD). If you need support in using Picard please read the [documentation](https://picard-docs.musicbrainz.org/) first and have a look at the [MusicBrainz community forums](https://community.metabrainz.org/c/picard).
 
 Installing
 ---------------------------

org.musicbrainz.Picard.appdata.xml.in

@@ -89,8 +89,8 @@
 
   <url type="homepage">https://picard.musicbrainz.org/</url>
   <url type="bugtracker">https://tickets.metabrainz.org/projects/PICARD/issues/</url>
-  <url type="faq">https://picard.musicbrainz.org/docs/faq/</url>
-  <url type="help">https://picard.musicbrainz.org/docs/</url>
+  <url type="faq">https://picard-docs.musicbrainz.org/en/faq/faq.html</url>
+  <url type="help">https://picard-docs.musicbrainz.org/</url>
   <url type="donation">https://metabrainz.org/donate</url>
   <url type="translate">https://www.transifex.com/musicbrainz/musicbrainz/picard/</url>
 

picard/const/__init__.py

@@ -38,6 +38,7 @@
 from picard import (
     PICARD_APP_NAME,
     PICARD_ORG_NAME,
+    PICARD_VERSION,
 )
 from picard.const.attributes import MB_ATTRIBUTES
 
@@ -68,20 +69,27 @@
 CAA_HOST = "coverartarchive.org"
 CAA_PORT = 443
 
+# Prepare documentation URLs
+if PICARD_VERSION.identifier == 'final':
+    DOCS_VERSION = "v{}".format(PICARD_VERSION.to_string(short=True))
+else:
+    DOCS_VERSION = ""  # points to latest version
+DOCS_BASE_URL = "https://picard-docs.musicbrainz.org/" + DOCS_VERSION + '/en'
+
 # URLs
 PICARD_URLS = {
-    'documentation':    "https://picard.musicbrainz.org/docs/",
-    'troubleshooting':  "https://picard.musicbrainz.org/docs/troubleshooting/",
-    'home':             "https://picard.musicbrainz.org/",
-    'doc_options':      "https://picard.musicbrainz.org/docs/options/",
-    'doc_scripting':    "https://picard.musicbrainz.org/docs/scripting",
-    'plugins':          "https://picard.musicbrainz.org/plugins/",
-    'forum':            "https://community.metabrainz.org/c/picard",
-    'donate':           "https://metabrainz.org/donate",
-    'chromaprint':      "https://acoustid.org/chromaprint#download",
-    'acoustid_apikey':  "https://acoustid.org/api-key",
+    'home':                "https://picard.musicbrainz.org/",
+    'documentation':       DOCS_BASE_URL + '/',
+    'troubleshooting':     DOCS_BASE_URL + '/en/troubleshooting/troubleshooting.html',
+    'doc_options':         DOCS_BASE_URL + '/en/config/configuration.html',
+    'doc_scripting':       DOCS_BASE_URL + '/en/scripting.html',
     'doc_cover_art_types': "https://musicbrainz.org/doc/Cover_Art/Types",
-    'acoustid_track': "https://acoustid.org/track/",
+    'plugins':             "https://picard.musicbrainz.org/plugins/",
+    'forum':               "https://community.metabrainz.org/c/picard",
+    'donate':              "https://metabrainz.org/donate",
+    'chromaprint':         "https://acoustid.org/chromaprint#download",
+    'acoustid_apikey':     "https://acoustid.org/api-key",
+    'acoustid_track':      "https://acoustid.org/track/",
 }
 
 # Various Artists MBID