DEV Community

E Daugherty
E Daugherty

Posted on

10 Mac tips for PR descriptions, commit messages and Slack updates people actually read (2026)

Most of the code you ship gets reviewed by someone who first reads your words: the PR description, the commit message, the Slack update that says it's ready. "Fixed stuff" and a 40-file diff is how a quick review turns into a two-day thread.

None of this needs a writing course. Here are the tips and Mac tools I'd use to make dev writing faster to produce and easier to read, grouped by where the words end up.

Pull request descriptions

1. Put a PR template in the repo

Add .github/pull_request_template.md and every new pull request opens with your headings already filled in: what changed, why, how to test, linked issue. You stop writing the structure from scratch, and reviewers always know where to look.

Cost: free on GitHub. GitHub Docs

2. Let Copilot draft the summary, then add the "why"

In the PR description field, the Copilot button can generate a summary of the changes. It ignores whatever is already in the box, so start blank, generate, then add the context only you know: why this approach, what you ruled out, what to look at first.

Cost: not included in Copilot Free; Pro is $10 a month. Copilot plans

3. Show the change with a short recording

For anything visual, a few seconds of screen recording beats a paragraph. Kap is an open-source Mac screen recorder that exports GIF, MP4, WebM or APNG, with trimming and click highlighting, and a GIF drops straight into a GitHub comment.

Cost: free, open source. getkap.co

4. Annotate before/after screenshots

Shottr is a tiny native screenshot app with arrows, highlights, pixelate for anything sensitive, and scrolling captures. Its overlay tool can even turn two screenshots into a before/after animation, which is perfect for UI PRs.

Cost: free to use (it occasionally asks you to buy); paid license on the site. shottr.cc

5. Sketch the architecture in Excalidraw

When a PR changes how pieces talk to each other, a quick hand-drawn diagram says it faster than bullet points. Excalidraw exports PNG or SVG, and it can convert Mermaid into an editable drawing if you already have one in the docs.

Cost: free; Excalidraw+ is $6 a month per user for cloud workspaces and more AI requests. Excalidraw+ pricing

Commit messages

6. Split commits by line, not by file

A good commit message is easier when the commit does one thing. GitHub Desktop lets you click individual changed lines out of a commit, so a formatting fix and a logic change don't end up described in the same sentence.

Cost: free. GitHub Desktop docs

7. Generate a first draft of the message, then edit it

With Copilot access, GitHub Desktop has a button that writes a commit summary and description from your staged changes, and it follows your repository's custom instructions and commit rulesets. Treat it as a draft: trim it to one clear subject line and keep the "why" in the body.

Cost: GitHub Desktop is free; generation needs Copilot access. GitHub Desktop docs

8. Use a Git client built for history cleanup

If you squash, reorder and reword commits before review, Tower makes that visual on Mac and Windows, with pull requests for GitHub, GitLab, Bitbucket and Azure DevOps built in. Students get 6 months of Pro free.

Cost: Basic is $69 a year, Pro $129 a year, with a 30-day free trial. git-tower.com/pricing

Slack updates and async check-ins

9. Schedule the update instead of sending it at midnight

Writing your status update at the end of a late session is fine; sending it then isn't. In Slack desktop, click the arrow next to the send button to schedule the message, and manage it later under Drafts & sent.

Cost: built into Slack. Slack Help

10. Draft faster in the box you're already typing in

DraftKey sits in the menu bar and suggests the next few words as you type in your Mac apps, so you press Tab to accept and keep going. Select a rambling Slack message and use Shorter, Clearer or a tone change, then review the updated draft before you insert it. You choose which apps it runs in from settings.

DraftKey rewrite panel showing an updated draft with Fix writing, Shorter, Clearer and Tone options and an Insert button

Cost: $4.99 once for up to 3 Macs, with 500 free words per Mac to try it. Needs Apple Silicon, macOS 14+ and 8 GB of RAM (about a 1.12 GB download). getdraftkey.com

The short version

  • PRs: template for structure, Copilot for the summary, Kap or Shottr for proof, Excalidraw for the big picture.
  • Commits: one change per commit, then a draft message you actually edit.
  • Slack: schedule it, and keep it short enough to read on a phone.

What's the one line you wish every PR description on your team included?

Top comments (0)