Skip to content

docs: comprehensive README and architecture cleanup for v0.1.0 - #21

Closed
jatinkrmalik wants to merge 1 commit into
mainfrom
docs/readme-and-arch-cleanup
Closed

docs: comprehensive README and architecture cleanup for v0.1.0#21
jatinkrmalik wants to merge 1 commit into
mainfrom
docs/readme-and-arch-cleanup

Conversation

@jatinkrmalik

Copy link
Copy Markdown
Member

Final documentation cleanup before v0.1.0 alpha release.

README Fixes

  • Fixed truncated badge line
  • Consistent platform naming (VocaLinux / VocaMac / VocaWin) with platform icons
  • Fixed cross-platform table (proper links, no parenthesized URLs)
  • Removed broken PRD.md link
  • Added SoundManager.swift, scripts/, web/ to project structure
  • Added Sound Effects to Configuration section
  • Added build/install/uninstall script docs
  • Added Known Limitations section
  • Removed Roadmap section (tracked via GitHub Issues now)
  • Replaced Author section with 'Made with ❤️ for the macOS community!'
  • Removed all em-dashes

ARCHITECTURE.md Fixes

  • Fixed duplicate SettingsView in UI layer diagram
  • Fixed bundle.sh -> build.sh reference
  • Fixed incorrect cross-platform claims (WhisperKit and CoreML are Apple-only)
  • Added SoundManager to module dependency graph
  • Removed all em-dashes

README:
- Fix truncated badge line
- Use consistent platform naming (VocaLinux/VocaMac/VocaWin)
- Remove emojis from cross-platform links, use platform icons
- Fix cross-platform table consistency and links
- Remove broken PRD.md link
- Add SoundManager, scripts/, web/ to project structure
- Add Sound Effects to Configuration section
- Add build/install/uninstall script docs
- Add Known Limitations section
- Remove Roadmap (tracked via GitHub Issues now)
- Replace Author section with community footer
- Remove all em-dashes

ARCHITECTURE.md:
- Fix duplicate SettingsView in UI layer diagram
- Fix bundle.sh -> build.sh reference
- Fix incorrect cross-platform claims (WhisperKit/CoreML are Apple-only)
- Add SoundManager to module dependency graph
- Remove all em-dashes
@jatinkrmalik

Copy link
Copy Markdown
Member Author

Changes moved to PR #20

@jatinkrmalik
jatinkrmalik deleted the docs/readme-and-arch-cleanup branch March 5, 2026 05:07
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