Merge pull request #52 from nj-io/develop

chore: merge develop into main

Author: nj-io

.github/workflows/docs.yml

@@ -4,7 +4,7 @@ on:
   push:
     branches: [main]
     paths:
-      - "docs/**"
+      - "site-docs/**"
       - "mkdocs.yml"
       - "scripts/generate_cli_docs.py"
       - "src/social_hook/cli/**"

mkdocs.yml

@@ -3,9 +3,9 @@ site_description: Automated social media content from development activity
 site_url: https://nj-io.github.io/social-hook/docs/
 repo_url: https://github.com/nj-io/social-hook
 repo_name: nj-io/social-hook
-edit_uri: edit/main/docs/
+edit_uri: edit/main/site-docs/
 
-docs_dir: docs
+docs_dir: site-docs
 site_dir: site
 
 theme:

scripts/generate_cli_docs.py

@@ -1,13 +1,13 @@
 #!/usr/bin/env python3
 """Generate CLI reference documentation from the Typer app.
 
-Introspects the Click command tree and writes markdown files to docs/cli/.
+Introspects the Click command tree and writes markdown files to site-docs/cli/.
 Run from repo root: python scripts/generate_cli_docs.py
 
 Output structure:
-  docs/cli/index.md          — overview with global options and command list
-  docs/cli/<group>.md        — one page per command group (draft, project, etc.)
-  docs/cli/root-commands.md  — top-level commands (version, init, trigger, etc.)
+  site-docs/cli/index.md          — overview with global options and command list
+  site-docs/cli/<group>.md        — one page per command group (draft, project, etc.)
+  site-docs/cli/root-commands.md  — top-level commands (version, init, trigger, etc.)
 """
 
 from __future__ import annotations
@@ -25,7 +25,7 @@
 from social_hook.cli import app
 from social_hook.constants import PROJECT_SLUG
 
-DOCS_DIR = Path(__file__).resolve().parent.parent / "docs" / "cli"
+DOCS_DIR = Path(__file__).resolve().parent.parent / "site-docs" / "cli"
 
 # Commands to exclude from docs (internal hooks)
 HIDDEN_COMMANDS = {"commit-hook", "git-hook", "narrative-capture"}
@@ -271,7 +271,7 @@ def main() -> None:
     index_path.write_text(index_page)
     print(f"  wrote {index_path.relative_to(DOCS_DIR.parent.parent)}")
 
-    print(f"\nGenerated {len(groups) + 2} files in docs/cli/")
+    print(f"\nGenerated {len(groups) + 2} files in site-docs/cli/")
 
 
 if __name__ == "__main__":