From 903cde6bafc7884e49c27c20e49b93769313acda Mon Sep 17 00:00:00 2001
From: Alexander Stehlik <alexander.stehlik@gmail.com>
Date: Wed, 22 Apr 2020 02:57:47 +0200
Subject: [PATCH] [TASK] Update Documentation/Settings.cfg from example

---
 Documentation/Settings.cfg | 103 +++++++++++++++++++++++--------------
 1 file changed, 65 insertions(+), 38 deletions(-)

diff --git a/Documentation/Settings.cfg b/Documentation/Settings.cfg
index 2b66859d..7f240df5 100644
--- a/Documentation/Settings.cfg
+++ b/Documentation/Settings.cfg
@@ -17,54 +17,81 @@
 
 [general]
 
-; endless list of all of the general simple settings
-; you can use in 'conf.py'
+# .................................................................................
+# ...   (required) title (displayed in left sidebar (desktop) or top panel (mobile)
+# .................................................................................
 
-project     = HTML5 media kit for TYPO3
-version     = 
-release     = 10.0.0
-t3author    = Alexander Stehlik
-copyright   = since 2013 by Alexander Stehlik
+project     = {extension.name}
 
-description = Adds a content element for HTML5 video and audio embedding.
-              Allows multiple video and audio formats in each element.
+# .................................................................................
+# ...   (recommended) version, displayed next to title (desktop) and in <meta name="book-version"
+# .................................................................................
+
+release     = {extension.version}
+
+# .................................................................................
+# ...  (recommended) displayed in footer
+# .................................................................................
+
+copyright   = by Alexander Stehlik
 
 [html_theme_options]
 
-github_branch        =
-github_commit_hash   =
+# .................................................................................
+# ...  (recommended) to get the "Edit me on Github Button"
+# .................................................................................
+
+github_branch        = develop
 github_repository    = astehlik/typo3-extension-html5mediakit
-github_revision_msg  =
-github_sphinx_locale =
-project_contact      =
+
+
+# .................................................................................
+# ...  (recommended) Fill in values to get links in the "Related Links" section
+# .................................................................................
+
+# usually an email address
+project_contact      = alexander.stehlik.deleteme@gmail.com
+
+# URL of online discussions, you can leave this blank
 project_discussions  =
+
+# URL of webpage of your extension (if it has one)
 project_home         =
+
+# URL to Issues
 project_issues       = https://github.com/astehlik/typo3-extension-html5mediakit/issues
-project_repository   = https://github.com/astehlik/typo3-extension-html5mediakit.git
-use_opensearch       =
+
+# URL of repository
+project_repository   = https://github.com/astehlik/typo3-extension-html5mediakit
 
 
 [intersphinx_mapping]
 
-; Comment out what you don't use.
-; Uncomment only what you actually use in crossreferencing!
-
-# t3api         = https://typo3.org/api/typo3cms/
-# t3cgl         = https://docs.typo3.org/typo3cms/CodingGuidelinesReference/
-# t3coreapi     = https://docs.typo3.org/typo3cms/CoreApiReference/
-# t3editors     = https://docs.typo3.org/typo3cms/EditorsTutorial/
-# t3extbasebook = https://docs.typo3.org/typo3cms/ExtbaseFluidBook/
-# t3fal         = https://docs.typo3.org/typo3cms/FileAbstractionLayerReference/
-# t3inside      = https://docs.typo3.org/typo3cms/InsideTypo3Reference/
-# t3install     = https://docs.typo3.org/typo3cms/InstallationGuide/
-# t3l10n        = https://docs.typo3.org/typo3cms/FrontendLocalizationGuide/
-# t3security    = https://docs.typo3.org/typo3cms/SecurityGuide/
-# t3services    = https://docs.typo3.org/typo3cms/Typo3ServicesReference/
-# t3skinning    = https://docs.typo3.org/typo3cms/SkinningReference/
-# t3start       = https://docs.typo3.org/typo3cms/GettingStartedTutorial/
-# t3tca         = https://docs.typo3.org/typo3cms/TCAReference/
-# t3templating  = https://docs.typo3.org/typo3cms/TemplatingTutorial/
-# t3ts45        = https://docs.typo3.org/typo3cms/TyposcriptIn45MinutesTutorial/
-# t3tsconfig    = https://docs.typo3.org/typo3cms/TSconfigReference/
-t3tsref       = https://docs.typo3.org/typo3cms/TyposcriptReference/
-# t3tssyntax    = https://docs.typo3.org/typo3cms/TyposcriptSyntaxReference/
+# .................................................................................
+# for cross-referencing across manuals (intersphinx) with :ref:
+#
+# You must uncomment all manuals you use in your cross-references
+#
+# Example usage:
+#   :ref:`t3contribute:start` will link to start page of Contribution Guide
+# .................................................................................
+
+h2document    = https://docs.typo3.org/m/typo3/docs-how-to-document/master/en-us/
+# t3coreapi     = https://docs.typo3.org/m/typo3/reference-coreapi/master/en-us/
+# t3editors     = https://docs.typo3.org/m/typo3/tutorial-editors/master/en-us/
+# t3extbasebook = https://docs.typo3.org/m/typo3/book-extbasefluid/master/en-us/Index.html
+# t3install     = https://docs.typo3.org/m/typo3/guide-installation/master/en-us/
+# t3l10n        = https://docs.typo3.org/m/typo3/guide-frontendlocalization/master/en-us/
+# t3start       = https://docs.typo3.org/m/typo3/tutorial-getting-started/master/en-us/
+# t3sitepackage = https://docs.typo3.org/m/typo3/tutorial-sitepackage/master/en-us/
+# t3tca         = https://docs.typo3.org/m/typo3/reference-tca/master/en-us/
+# t3templating  = https://docs.typo3.org/m/typo3/tutorial-templating-with-fluid/master/en-us/
+# t3ts45        = https://docs.typo3.org/m/typo3/tutorial-typoscript-in-45-minutes/master/en-us/
+# t3tsconfig    = https://docs.typo3.org/m/typo3/reference-tsconfig/master/en-us/
+t3tsref       = https://docs.typo3.org/m/typo3/reference-typoscript/master/en-us/
+
+[extensions]
+
+# This is required for embedding YouTube videos
+
+any_name_youtube = sphinxcontrib.youtube