Good TL;DRs
| Example | What it means |
|---|---|
| TL;DR: the outage was caused by an expired certificate; renewal is now automated. | Incident summary |
| TL;DR: this PR moves auth to middleware, no behavior change. | PR description |
| TL;DR: we recommend option B; details below. | Decision doc |
| TL;DR: I need your approval by Thursday. | Clear ask |
Wikipedia's TL;DR article describes both uses: a reply saying a text was too long, and a summary added by the writer. Lowercase “tl;dr” and “TLDR” mean the same.
Tips
- Put it first, not at the end.
- One or two sentences, with the decision or the ask.
- Avoid replying “tl;dr” to a colleague's message; ask for a summary instead: “Could you add a short summary?”
Related: pull request description example and IIRC meaning.
Practice free in the browser: pull request phrases and technical English phrases.
Learn the phrases around the word
Knowing what an acronym means is step one; using it naturally in a standup or a Slack thread is step two. Devlingo, Gambit Studio's English for developers app, has over 3,600 phrases for standups, code review, Slack, email, meetings and pull requests, ten new ones a day with real context and pronunciation guidance, plus a widget with the phrase of the day.