Skip to content

docs: documentation improvements and CLAUDE.md#160

Merged
basnijholt merged 8 commits intomainfrom
docs-improvements
Jan 3, 2026
Merged

docs: documentation improvements and CLAUDE.md#160
basnijholt merged 8 commits intomainfrom
docs-improvements

Conversation

@basnijholt
Copy link
Copy Markdown
Owner

@basnijholt basnijholt commented Jan 3, 2026

Summary

Changes

New file:

  • CLAUDE.md - Development rules, build commands, and architecture overview

Documentation review prompt:

  • Updated for auto-generated options tables via docs_gen module
  • Shifted focus to prose, examples, and workflows that still need human judgment

Fixes across docs:

  • uv tools installuv tool install typo fixes
  • Emoji callout → GitHub-style > [!WARNING] in docker.md
  • "Wyoming Faster Whisper" → "Wyoming Whisper" with platform notes (MLX on Apple Silicon)
  • Fixed gpt-5-mini<your-model> placeholder in rag-proxy examples
  • Removed wsl prefix from Windows AutoHotkey scripts
  • Improved macOS service docs with brew/launchd options
  • Fixed markdown list formatting in install-hotkeys.md

Test plan

  • Verify CLAUDE.md is accurate and helpful
  • Verify docs-review.md reflects new automated workflow
  • Check install-hotkeys page renders correctly

…stall-hotkeys formatting

- Update docs-review.md to reflect that options tables are now auto-generated
  via the docs_gen module, removing manual verification steps
- Add docs_gen function reference and update_docs.py command
- Shift review focus to prose, examples, and workflows that still need judgment
- Fix install-hotkeys.md markdown list formatting with proper blank lines
  and bold platform headers
- Fix `uv tools install` → `uv tool install` typo across installation docs
- Convert emoji callout to GitHub-style `> [!WARNING]` in docker.md
- Update "Wyoming Faster Whisper" → "Wyoming Whisper" with platform notes
  (faster-whisper on Linux/Intel, MLX Whisper on Apple Silicon)
- Fix `gpt-5-mini` → `<your-model>` placeholder in rag-proxy examples
- Remove `wsl` prefix from Windows AutoHotkey scripts
- Improve macOS service documentation with brew/launchd options
- Clarify transcribe behavior (Wyoming streams live vs OpenAI uploads)
- Minor wording improvements in index.md
Add development guidance file including:
- Development rules (functional style, DRY, simplicity, testing)
- Build and development commands (uv, pytest, pre-commit, ruff)
- Architecture overview (CLI structure, provider pattern, key modules)
- Agent pattern documentation
- Background process management
- Documentation auto-generation workflow
@basnijholt basnijholt changed the title docs: update docs-review prompt for auto-generated options docs: documentation improvements and CLAUDE.md Jan 3, 2026
@basnijholt basnijholt merged commit e228ffd into main Jan 3, 2026
10 of 11 checks passed
@basnijholt basnijholt deleted the docs-improvements branch January 3, 2026 09:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant