Doc review 1.1.0rc1

Review of the documentation

docs/conf.py

@@ -86,16 +86,18 @@ tag_re = re.compile(r'^\d+\.\d+.*')
 match = tag_re.match(git_version)
 if match:
     # Releasing a tag
-    print('This is a tag: %s'% (git_version,))
+    print(f'This is a tag: {git_version}')
     release = git_version
+    version_type = 'tags'
 else:
     # Releasing a branch
-    print('This is a branch: %s'% (git_version,))
+    print(f'This is a branch: {git_version}')
     release = version+'-'+git_version
+    version_type = 'heads'
 version = git_version
 release_badge = release.replace('-', '--')
 
-print('git_version: %s' % (git_version,))
+print(f'Using {git_version=}')
 
 rst_prolog = """
 .. |Badge doc| image:: https://img.shields.io/badge/docs-{release_badge}-brightgreen
@@ -111,8 +113,13 @@ def ultimateReplace(app, docname, source):
         result = result.replace(key, app.config.ultimate_replacements[key])
     source[0] = result
 
+reference_otb_version = '9.0.0'
+
+print(f'Reference OTB Version: {reference_otb_version} -- used in documentation')
 ultimate_replacements = {
-    "{VERSION}" : version
+    "{REF_OTB_VERSION}" : reference_otb_version,
+    "{VERSION}" : version,
+    "{VERSION_TYPE}" : version_type,
 }
 
 # The language for content autogenerated by Sphinx. Refer to documentation