Skip to main content

How-to

Dictation in GitHub pull request descriptions (Mac)

Dictate the explanation and test plan by voice, then edit identifiers and code blocks by hand.

Last updated: 2025-12-27

A good PR description is usually the difference between a fast review and a slow one — and it’s mostly prose. Dictation helps you write it without context-switching.

Option A: Use macOS Dictation

  1. Open your pull request on GitHub and click into the description field (or edit it).
  2. Start macOS Dictation (shortcut often Fn twice).
  3. Dictate the summary and test plan. Stop Dictation to insert.
  4. Edit: file paths, identifiers, and code blocks are faster to type.

Option B: Use Voice Type (dedicated hotkey across apps)

  1. Install Voice Type and set a hold‑to‑dictate hotkey.
  2. Hold hotkey to dictate; release to finalize.
  3. Use it for PR descriptions, review comments, and tickets without changing tools.

A PR description structure you can dictate

  1. What changed (1–3 sentences).
  2. Why (the motivation / problem).
  3. How (approach + tradeoffs).
  4. Test plan (bullets).
  5. Screenshots (if UI).

If your repo uses PR templates, dictation becomes even easier: you just “fill in the blanks” by voice.

Keep going

Sources

Try Voice Type (7‑day free trial)