Skip to content

README.md

Latest commit

 

History

History
66 lines (51 loc) · 2.62 KB

README.md

File metadata and controls

66 lines (51 loc) · 2.62 KB

Documentation

This directory contains documentation for using the Kefer Astrology sidecar module.

User Documentation

References

  • docs/site/content/readme.md - Project overview and quickstart
  • docs/site/content/installation.md - Environment setup and venv strategy
  • docs/site/content/architecture.md - System architecture (includes storage responsibilities)
  • docs/site/content/cli_reference.md - Complete CLI command reference
  • docs/site/content/fastapi_tauri.md - Recommended integration for React + FastAPI + Tauri

Auto-Generated Docs

  • auto/ - Module documentation generated from docstrings
    • auto/cli.md - CLI module
    • auto/storage.md - Storage module
    • auto/services.md - Services module
    • auto/workspace.md - Workspace module
    • etc.

Developer Documentation

  • docs/site/content/enums.md - Enumeration reference
  • docs/site/content/models.mmd - Mermaid class diagram
  • docs/site/content/testing_guide.md - How to write and run tests
  • docs/site/content/performance_bottleneck_analysis.md - Performance investigation notes
  • docs/site/content/performance_fix_summary.md - Performance remediation summary
  • docs/site/content/industry_standards_audit.md - Code quality audit status
  • docs/site/content/industry_standards_issues.md - Condensed outstanding issues

Generating Documentation

Auto-Generate Docs

make docs

This generates:

  • docs/site/content/auto/*.md - Module API documentation from docstrings
  • docs/site/content/models.mmd - Class diagram
  • docs/site/content/enums.md - Enum reference

Serve Docs Locally (Hugo)

hugo server --source docs/site --config hugo.toml --baseURL http://localhost:1313/ --appendPort=false

Hugo sources live under docs/site/ and the built site is written to docs/ via --destination docs. Full setup steps are in installation.md under "Generating Documentation".

Manual Documentation

User guides and integration docs are maintained manually under docs/site/content/ so the Hugo site is the main documentation source of truth.

When linking images from content pages, prefer ../example.png so links resolve at the site root during local and hosted builds.

Quick Links

  • For Project Overview: See docs/site/content/readme.md
  • For Installation: See docs/site/content/installation.md
  • For CLI Usage: See docs/site/content/cli_reference.md
  • For React/FastAPI/Tauri Integration: See docs/site/content/fastapi_tauri.md
  • For Storage: See docs/site/content/architecture.md
  • For API Reference: See docs/site/content/auto/