docs(python): align onboarding flows and add markdown validation

Author: digitallysavvy

.github/workflows/ci.yml

@@ -15,6 +15,8 @@ jobs:
           curl -sSL https://install.python-poetry.org | python - -y --version 1.5.1
       - name: Install dependencies
         run: poetry install
+      - name: Validate docs
+        run: poetry run python scripts/validate_docs.py
       - name: Compile
         run: poetry run mypy .
   test:
@@ -31,6 +33,8 @@ jobs:
           curl -sSL https://install.python-poetry.org | python - -y --version 1.5.1
       - name: Install dependencies
         run: poetry install
+      - name: Validate docs
+        run: poetry run python scripts/validate_docs.py
 
       - name: Test
         run: poetry run pytest -rP .