How to Adapt Your Writing Style in English at Work
ESL English learning: Master writing style and formatting for Slack, email, and PR descriptions in tech workplaces with register shifts.
Understanding Register: Slack vs Email vs Docs
In tech, you constantly shift between writing styles depending on where you're communicating. A quick Slack message to your team can be chatty and informal, but an email to a stakeholder or a PR description needs a more neutral or formal register.
Register refers to the level of formality in your writing. Getting it wrong can make you seem unprofessional (too casual in docs) or cold and distant (too formal in Slack with teammates).
| Channel | Register | Example Opening |
|---|---|---|
| Slack (team channel) | Informal/Chatty | hey team, quick q about the auth flow |
| Slack (cross-team) | Neutral | Hi payments team—we have a question about the webhook setup |
| Email (internal) | Neutral | Hi Maria, I wanted to follow up on the API migration timeline. |
| Email (external/exec) | Formal | Dear Mr. Chen, Thank you for your time yesterday. I'm writing to confirm... |
| PR description | Neutral/Technical | This PR refactors the authentication middleware to support OAuth 2.0. |
| RFC/Design doc | Formal/Technical | This document proposes a new caching strategy for the recommendation service. |
Culture Note
In most US and European tech companies, Slack is deliberately casual—even with managers. But when you're unsure of the culture, start neutral and mirror the tone others use.
Key Writing Vocabulary for Tech Professionals
These terms help you talk about writing and formatting in professional contexts. You'll hear them in code reviews, documentation discussions, and style guide debates.
| Term | Tech Definition | Example Sentence |
|---|---|---|
| draft (v/n) | Write a first version; the first version itself | I'm drafting the RFC now—should have it ready for review tomorrow. |
| jot down | Write something quickly to remember it | Let me jot down that endpoint URL before I forget. |
| write up | Create a proper final document from notes/drafts | Can you write up the incident postmortem by Friday? |
| format (v) | Arrange text with headers, bullets, spacing for readability | Please format the README so it's easier to scan. |
| run off / print out | Generate a copy (digital or physical) | I'll run off a PDF of the architecture diagram for the meeting. |
| cut and paste / copy and paste | Move or duplicate text electronically | I copy and paste the PR template, then fill in the details. |
- Scribble (v): Write quickly without care — 'I scribbled some notes during the standup.'
- Chatty (adj): Informal, conversational tone — 'Slack messages can be chatty, but RFCs shouldn't be.'
- Typescript: An author's unpublished text — In tech, usually refers to the TypeScript language, but in writing contexts means a draft document.
Formatting Vocabulary You'll Use Daily
When discussing documentation, code comments, or PR descriptions, you need precise vocabulary for formatting elements.
| Term | Symbol/Example | Tech Usage |
|---|---|---|
| bullet point | • | Use bullet points for listing acceptance criteria in tickets. |
| asterisk | * | Markdown uses asterisks for bold (text) and italics (text). |
| bold / in bold | text | Put the breaking change warning in bold so reviewers don't miss it. |
| italics / italicized | text | File names are often italicized in documentation. |
| upper case / CAPS | BREAKING CHANGE | Commit prefixes like BREAKING CHANGE are written in upper case. |
| lower case | camelCase | Variable names use lower case letters with camelCase formatting. |
| angle brackets | < > | Angle brackets show placeholders: <your-api-key> |
| square brackets | [ ] | Square brackets in Markdown create links: [text](url) |
| curly brackets / braces | { } | Curly brackets define code blocks in most languages. |
| indented | text | Nested lists should be indented for readability. |
Pronunciation Tip
Asterisk is often mispronounced. It's /ˈæs.tə.rɪsk/ (AS-tuh-risk), not 'asterix' or 'asterick'. The stress is on the first syllable.
Scenario: Shifting from Slack to Email
You've been chatting with a colleague on Slack about a project delay. Now you need to email the same information to a director who wasn't in the conversation. Watch how the register shifts:
| Slack to Teammate | Email to Director |
|---|---|
| hey, so the API migration is gonna be late 😬 | Subject: API Migration Timeline Update |
| ran into some auth issues we didn't expect | Hi Sarah, I wanted to update you on the API migration timeline. |
| prob need another week, maybe two | We encountered unexpected authentication issues that require additional work. |
| will keep u posted | Our revised estimate is 1-2 additional weeks. I'll send a detailed breakdown by EOD tomorrow. |
- Contractions: Use freely in Slack ('gonna', 'prob'), avoid in formal emails ('going to', 'probably')
- Emoji: Common in Slack, rarely appropriate in emails to executives
- Hedging: 'maybe two' → 'Our revised estimate is 1-2 weeks' (more precise, professional)
- Sign-off: Slack often has none; emails need 'Best,' 'Thanks,' or similar
Scenario: Writing a Clear PR Description
A good PR description is informative but scannable. Reviewers are busy—they need to understand what changed and why without reading a novel.
| ❌ Weak PR Description | ✅ Strong PR Description |
|---|---|
| fixed some stuff | What: Refactored authentication middleware |
| changed the auth thing because it was broken | Why: The previous implementation didn't support OAuth 2.0 refresh tokens |
| (no context) | How: Extracted token validation into a separate service class |
| (no testing info) | Testing: Added unit tests for token refresh flow; manually tested with staging OAuth provider |
Format for Scan-ability
Use bold headings (What/Why/How/Testing), bullet points for multiple changes, and keep paragraphs short. Reviewers often scan PRs on mobile.
- Be specific: 'fixed auth' → 'Fixed OAuth 2.0 refresh token handling'
- Explain the why: Reviewers understand your decisions better when they know the reasoning
- Link related issues: 'Fixes #1234' or 'Related to RFC-089'
- Call out risks: 'Note: This changes the session cookie format—coordinate with frontend team'
Common Writing Mistakes (Heard at Work)
These are real register and formatting mistakes that can make your writing unclear or unprofessional.
| ❌ Heard at Work | ✅ Better English |
|---|---|
| pls advice | Please advise (or better: Could you share your thoughts?) |
| Can you make a look? | Can you take a look? |
| I will revert to you | I will get back to you (revert ≠ reply) |
| Kindly do the needful | Could you please handle this? / Please take care of this. |
| As per our discuss | As we discussed / Following our conversation |
| Please find attached herewith | I've attached... / See the attached... |
Register Awareness
Phrases like 'do the needful' and 'revert back' are common in Indian English but may confuse colleagues from other regions. When writing to international teams, stick to globally understood phrases.
Pronunciation Guide: Tricky Writing Terms
These formatting and writing terms come up in meetings about documentation and style. Mispronouncing them can cause confusion.
asterisk /ˈæs.tə.rɪsk/
AS-tuh-risk
Often said as 'asterix' or 'asterick'—the ending is -isk, not -ix or -ick
italics /ɪˈtæl.ɪks/
ih-TAL-iks
Stress is on the second syllable, not 'EYE-talics'
formatting /ˈfɔːr.mæt.ɪŋ/
FOR-mat-ing
Three syllables, not 'for-MAT-ting'
indented /ɪnˈden.tɪd/
in-DEN-tid
Stress on second syllable; not 'IN-dented'
brackets /ˈbræk.ɪts/
BRAK-its
Short 'a' sound, not 'brack-EETS'
Practice Exercises
Multiple choice
Choose the best answer.
Which register is most appropriate for a PR description?
Complete the sentence
Type the missing word or phrase.
Complete the sentence: 'Let me ______ down that API endpoint before I forget it.'
Multiple choice
Choose the best answer.
What does 'write up' mean in a tech workplace context?
Multiple choice
Choose the best answer.
Which is the correct replacement for 'Please do the needful'?