Add mkdocs-material dependency to requirements.txt

harvester/harvester.py

@@ -15,9 +15,12 @@ def sanitize_name(name: str) -> str:
     """Sanitize a name to be filesystem-friendly."""
     return name.lower().replace(" ", "-").replace("_", "-")
 
-def harvest_readmes(organization: str, branch: list[str | None] = ["main", "dev", None], projects: list[str] = [], output_path: str = "reference") -> None:
+def harvest_readmes(organization: str | Organization, branch: list[str | None] = ["main", "dev", None], projects: list[str] = [], output_path: str = "reference") -> None:
     """Harvest README files from repositories."""
-    org = Organization("https://dev.azure.com/" + organization, token=get_token())
+    if isinstance(organization, str):
+        org = Organization("https://dev.azure.com/" + organization, token=get_token())
+    else:
+        org = organization
 
     if projects:
         # Target specific projects

make-venv.sh

@@ -1,6 +1,8 @@
 #! /usr/bin/env bash
 
-python3 -m venv .venv
+VERSION="${1:-3}"
+
+python${VERSION} -m venv .venv
 ./.venv/bin/pip install --upgrade pip
 ./.venv/bin/pip install -r requirements.txt
 

mkdocs.yml

@@ -1,4 +1,4 @@
-site_name: Reference
+site_name: Reference Documentation
 docs_dir: reference
 theme: 
   name: material

requirements.txt

@@ -2,3 +2,4 @@ debugpy==1.8.17
 azure-identity==1.25.1
 requests==2.32.5
 loki-logger-handler==1.1.2
+mkdocs-material>=1.5.2

sk/__init__.py

@@ -0,0 +1 @@
+# My helper tools