Skip to content

docs: improve README formatting and clarity#77

Merged
alexkroman merged 2 commits into
mainfrom
claude/kind-clarke-3yq6xe
Jun 11, 2026
Merged

docs: improve README formatting and clarity#77
alexkroman merged 2 commits into
mainfrom
claude/kind-clarke-3yq6xe

Conversation

@alexkroman

Copy link
Copy Markdown
Collaborator

Improve the README's readability and structure by breaking up code examples and adding descriptive headers.

Changes:

  • Separated installation instructions for pipx and uv into distinct code blocks with clear labels
  • Added descriptive headers above each command example (e.g., "Guided setup:", "Transcribe the hosted sample:")
  • Broke up multi-command examples into individual code blocks, one per command
  • Improved development section formatting with clearer step-by-step instructions
  • Enhanced visual hierarchy to make it easier to scan and find specific commands

These changes maintain all existing content while improving the document's scannability and user experience, particularly for users looking for specific commands or installation methods.

https://claude.ai/code/session_01YMabdRNxaa9sJVdJzhhZk4

Split the multi-command fenced blocks (pipx/uv install, basic usage,
quick examples, contributing) into one block per independent command so
each gets its own copy button; the Homebrew block stays together since
its three lines are a single sequential install procedure.

https://claude.ai/code/session_01YMabdRNxaa9sJVdJzhhZk4
@alexkroman alexkroman enabled auto-merge (squash) June 11, 2026 22:37
@alexkroman alexkroman merged commit 099f4fd into main Jun 11, 2026
8 checks passed
@alexkroman alexkroman deleted the claude/kind-clarke-3yq6xe branch June 11, 2026 22:44
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