docs(all): integrated documentation using canonical MkDocs template

.github/workflows/deploy_docs.yml

@@ -0,0 +1,36 @@
+# Copyright IBM Corp. All Rights Reserved.
+#
+# SPDX-License-Identifier: CC-BY-4.0
+
+name: Deploy Docs (Github Pages)
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'docs/**'
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+jobs:
+  deploy-docs:
+    runs-on: ubuntu-latest
+    steps:
+      # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
+      - uses: actions/checkout@v3
+
+      - name: Use Python 3.x
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.10'
+          cache: 'pip' # caching pip dependencies
+
+      - name: Install dependencies
+        run: pip install -r requirements.txt
+        working-directory: docs
+
+      - name: Build and publish
+        run: git pull && mkdocs gh-deploy
+        working-directory: docs

MAINTAINERS.md

@@ -6,17 +6,17 @@ Maintainers
 | Name | GitHub | Chat |
 |------|--------|------|
 | Jonathan Hamilton | [jonathan-m-hamilton][jonathan-m-hamilton] | JHamilton |
-| Izuru Sato | [izuru0][izuru0] | Izuru Sato#6434 |
-| Peter Somogyvari | [petermetz][petermetz] | peter_somogyvari#3365 |
-| Takuma TAKEUCHI | [takeutak][takeutak] | takeutak#7220 |
+| Izuru Sato | [izuru0][izuru0] | izurusato |
+| Peter Somogyvari | [petermetz][petermetz] | peter_somogyvari |
+| Takuma TAKEUCHI | [takeutak][takeutak] | takeutak |
 | Jagpreet Singh Sasan | [jagpreetsinghsasan][jagpreetsinghsasan] | jagpreetsinghsasan |
-| Venkatraman Ramakrishna | [VRamakrishna][VRamakrishna] | Ramakrishna#6645 |
-| Sandeep Nishad | [sandeepnRES][sandeepnRES] | sandeepn#1092 |
+| Venkatraman Ramakrishna | [VRamakrishna][VRamakrishna] | vramaiitkgp |
+| Sandeep Nishad | [sandeepnRES][sandeepnRES] | sandeepn |
 
 [jonathan-m-hamilton]: https://github.com/jonathan-m-hamilton
 [izuru0]: https://github.com/izuru0
 [petermetz]: https://github.com/petermetz
 [takeutak]: https://github.com/takeutak
 [jagpreetsinghsasan]: https://github.com/jagpreetsinghsasan
-[VRamakrishna]: https://github.com/VRamakrishna/
-[sandeepnRES]: https://github.com/sandeepnRES
+[VRamakrishna]: https://github.com/VRamakrishna
+[sandeepnRES]: https://github.com/sandeepnRES

docs-cactus/README.md

@@ -0,0 +1,7 @@
+### Building the docs
+```sh
+pip install -U Sphinx
+pip install -r pip-requirements.txt
+make html
+```
+Access the documents from **build/html/** folder.

docs/.gitignore

@@ -0,0 +1 @@
+site/

docs/CODEOWNERS

@@ -0,0 +1 @@
+* @VRamakrishna