Skip to content

Expand README with features, architecture, and getting started#72

Merged
alexkroman merged 1 commit into
mainfrom
claude/readme-davit-layout-2e8elw
Jul 8, 2026
Merged

Expand README with features, architecture, and getting started#72
alexkroman merged 1 commit into
mainfrom
claude/readme-davit-layout-2e8elw

Conversation

@alexkroman

Copy link
Copy Markdown
Collaborator

What & why

This PR significantly expands the README to provide clearer documentation for users and developers:

  • User-facing improvements: Added a concise intro explaining what Blurt does, a detailed Features section highlighting key capabilities, and a step-by-step "Getting started" guide to walk users from install to first dictation
  • Developer-facing improvements: Added an Architecture section with a visual breakdown of the codebase structure, clarified build instructions, and expanded the BlurtEngine documentation pointer
  • Metadata updates: Corrected the minimum macOS requirement from 26+ to 15+ (with 26 recommended for Liquid Glass UI), and updated the install instructions to be more concise

The changes reorganize and expand existing information rather than introducing new features, making the project more accessible to both end users and contributors.

How it was tested

  • scripts/check.sh passes (or CI will, if I'm not on a Mac)
  • I read AGENTS.md and this doesn't reintroduce anything deliberately removed
  • Docs updated (this is a documentation-only change)

No code changes; documentation only.

https://claude.ai/code/session_01SqgPLcuqqc8nehh388PWZM

…itecture tree

Restructure the README around a fuller layout: a one-line pitch and name
etymology up top, a native-tech summary of the engine, expanded feature
bullets, explicit Requirements, a numbered Getting Started walkthrough,
and an annotated source-tree Architecture section with a latency note.

Also corrects the minimum-OS claim to macOS 15+ (badge included) to match
Package.swift/project.yml after the macOS 15 support restore (#68).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SqgPLcuqqc8nehh388PWZM
@alexkroman alexkroman enabled auto-merge July 8, 2026 00:04
@alexkroman alexkroman disabled auto-merge July 8, 2026 00:09
@alexkroman alexkroman added this pull request to the merge queue Jul 8, 2026
Merged via the queue into main with commit b797374 Jul 8, 2026
6 checks passed
@alexkroman alexkroman deleted the claude/readme-davit-layout-2e8elw branch July 8, 2026 00:22
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.

2 participants