Remove docs folder to simplify URLs (#44)

* Remove docs folder to simplify URLs

* Set template files to be ignored

contributing/index.rst

@@ -115,12 +115,12 @@ build it locally:
    :hidden:
    
    self
-   contributing/contrib-types.rst
+   contrib-types.rst
-   contributing/gh-issues.rst
+   gh-issues.rst
-   contributing/build-locally.rst
+   build-locally.rst
-   contributing/writing-guidance.rst
+   writing-guidance.rst
-   contributing/submit-contribution.rst
+   submit-contribution.rst
-   contributing/get-help.rst
+   get-help.rst
 
 .. LINKS
 .. _Code of Conduct: https://ubuntu.com/community/ethos/code-of-conduct

custom_conf.py

@@ -163,7 +163,7 @@ myst_heading_anchors = 3
 # not need to be added here: myst_parser, sphinx_copybutton, sphinx_design,
 # sphinx_reredirects, sphinxcontrib.jquery, sphinxext.opengraph
 custom_extensions = [
-    'sphinx_tabs.tabs',
+#    'sphinx_tabs.tabs',
     'sphinxcontrib.mermaid',
     'sphinxcontrib.jquery',
 #    'canonical.youtube-links',
@@ -188,7 +188,7 @@ custom_required_modules = [
 # Add files or directories that should be excluded from processing.
 custom_excludes = [
     'cheatsheets/',
-    'docs/contributing/doc-templates/*',
+    'doc-templates/*',
     'doc-cheat-sheet*',
     'readme.rst',
     'legacy/*.md',
@@ -233,6 +233,8 @@ custom_tags = []
 #   :class: align-center
 #'''
 
+suppress_warnings = ['orphan']
+
 ############################################################
 ### PDF configuration
 ############################################################

explanation/index.rst

@@ -11,91 +11,91 @@ to use.
 Introduction to...
 ==================
 
-.. include:: explanation/introduction-to.rst
+.. include:: introduction-to.rst
     :start-line: 4
     :end-before: .. toctree::
 
 Virtualisation and containers
 =============================
 
-.. include:: explanation/virtualisation.rst
+.. include:: virtualisation.rst
     :start-line: 4
     :end-before: .. toctree::
 
 Networking
 ==========
 
-.. include:: explanation/networking.rst
+.. include:: networking.rst
     :start-line: 4
     :end-before: .. toctree::
 
 Active Directory integration
 ============================
 
-.. include:: explanation/active-directory.rst
+.. include:: active-directory.rst
     :start-line: 4
     :end-before: .. toctree::
 
 Security
 ========
 
-.. include:: explanation/security.rst
+.. include:: security.rst
     :start-line: 4
     :end-before: .. toctree::
 
 Cryptography
 ============
 
-.. include:: explanation/cryptography.rst
+.. include:: cryptography.rst
     :start-line: 4
     :end-before: .. toctree::
 
 Server installation
 ===================
 
-.. include:: explanation/installation.rst
+.. include:: installation.rst
     :start-line: 4
     :end-before: .. toctree::
 
 Storage
 =======
 
-.. include:: explanation/storage.rst
+.. include:: storage.rst
     :start-line: 4
     :end-before: .. toctree::
 
 Managing software
 =================
 
-.. include:: explanation/software.rst
+.. include:: software.rst
     :start-line: 4
     :end-before: .. toctree::
 
 Web services
 ============
 
-.. include:: explanation/web-services.rst
+.. include:: web-services.rst
     :start-line: 4
     :end-before: .. toctree::
 
 System tuning
 =============
 
-.. include:: explanation/performance.rst
+.. include:: performance.rst
     :start-after: _end-system-tuning-intro:
     :end-before: .. toctree::
 
 High Availability
 =================
 
-.. include:: explanation/high-availability.rst
+.. include:: high-availability.rst
     :start-line: 4
     :end-before: .. toctree::
 
 Multipath
 =========
 
-.. include:: explanation/multipath.rst
+.. include:: multipath.rst
     :start-line: 4
     :end-before: .. toctree::
 
@@ -104,16 +104,16 @@ Multipath
     :hidden:
     :titlesonly:
 
-    explanation/introduction-to.rst
+    introduction-to.rst
-    explanation/virtualisation.rst
+    virtualisation.rst
-    explanation/networking.rst
+    networking.rst
-    explanation/active-directory.rst
+    active-directory.rst
-    explanation/security.rst
+    security.rst
-    explanation/cryptography.rst
+    cryptography.rst
-    explanation/installation.rst
+    installation.rst
-    explanation/storage.rst
+    storage.rst
-    explanation/software.rst
+    software.rst
-    explanation/web-services.rst
+    web-services.rst
-    explanation/performance.rst
+    performance.rst
-    explanation/high-availability.rst
+    high-availability.rst
-    explanation/multipath.rst
+    multipath.rst