What's the difference between a 'feature' and an 'editorial' in technical writing?

A feature is an in-depth article focused on a specific technical topic (like a deep-dive into your caching architecture), while an editorial is an opinion piece from leadership expressing a viewpoint (like the CTO's perspective on AI adoption). Features are typically written by engineers; editorials by executives or senior leaders.

How do I use 'coverage' when reviewing a colleague's technical document?

Use 'coverage' to discuss how thoroughly a topic is addressed. For example: 'The RFC needs better coverage of security implications' or 'Can you expand the coverage of error handling?' It works as both a noun ('the coverage is insufficient') and relates to the verb 'cover' ('Does this cover all edge cases?').

What's the difference between a runbook and a postmortem?

A runbook is written before incidents happen—it contains step-by-step instructions for handling specific scenarios. A postmortem is written after an incident, analyzing what went wrong and documenting lessons learned. You follow the runbook during the incident; you write the postmortem afterward.

What does 'circulation' mean in the context of technical content?

In traditional publishing, circulation means the number of copies sold. In tech, it refers to readership or views. You might say: 'Our blog post got great circulation' meaning it was widely read and shared. It can also refer to internal distribution: 'The RFC has good circulation among stakeholders.'

Technical Writing Vocabulary: Publishing Terms for Engineers

Q: Is 'documentation' singular or plural in English?

'Documentation' is an uncountable noun, so it's always singular: 'The documentation is outdated,' not 'The documentations are outdated.' If you need a countable form, use 'document' or 'doc': 'These docs need updating.'

Pronunciation Guide: Technical Publishing Terms

These terms frequently appear in meetings about documentation and content. Practice the correct pronunciation to sound confident:

editorial /ˌed.ɪˈtɔː.ri.əl/

e-di-TOR-i-al

Saying 'ed-i-TOR-al' (skipping the 'i' in the fourth syllable)

supplement /ˈsʌp.lɪ.mənt/

SUP-pli-ment

Saying 'sup-ple-MENT' with stress on the last syllable

circulation /ˌsɜː.kjəˈleɪ.ʃən/

sir-kyu-LAY-shun

Saying 'SIR-kyu-lay-shun' with stress on the first syllable

postmortem /ˌpəʊstˈmɔː.təm/

post-MOR-tem

Saying 'POST-mor-tem' with stress on the first syllable

changelog /ˈtʃeɪndʒ.lɒɡ/

CHANGE-log

Saying 'chan-ge-LOG' as three syllables

Why Publishing Vocabulary Matters for Tech Professionals

Whether you're drafting an RFC, writing a post for your company's engineering blog, or reviewing a colleague's design doc, you're participating in technical publishing. Understanding editorial vocabulary helps you communicate more precisely with content teams, give better feedback, and write more effectively.

Many terms from traditional print media—like 'editorial,' 'feature,' and 'circulation'—appear regularly in tech contexts. An engineering blog editor might ask you to write a 'feature' on your team's migration to Kubernetes, or your VP might publish an 'editorial' about the company's AI strategy.

Culture Note

In many tech companies, engineers are expected to contribute to the engineering blog. This is often tied to performance reviews and visibility. Understanding publishing vocabulary helps you navigate these conversations confidently.

Key Publishing Terms for Technical Content

Term	General Definition	Tech Workplace Example
editorial	An opinion piece from leadership or editors	The CTO published an editorial on why we're moving to a microservices architecture.
feature	An in-depth article on a specific topic	I'm writing a feature on how we reduced latency by 40% using edge caching.
coverage	How thoroughly a topic is addressed	The RFC needs better coverage of security implications.
circulation	Number of readers or views	Our engineering blog post on GraphQL got amazing circulation—over 50,000 views.
supplement	Additional material included with main content	The design doc includes a supplement with benchmark data.
classified	Categorized listings or sections	Check the internal job board—it's like our classified ads for open roles.

Note that 'coverage' works as both a noun and relates to the verb 'cover.' You might say: 'Does the RFC cover error handling?' or 'The coverage of error handling is insufficient.'

Types of Technical Written Content

Tech workplaces produce many types of written content beyond code. Each has its own conventions and vocabulary.

Document Type	Description	Example Usage
RFC (Request for Comments)	A proposal document for significant technical changes	Before we refactor the auth system, I need to write an RFC for the architecture review.
design doc	A detailed technical specification for a feature or system	The design doc should cover database schema, API contracts, and rollout plan.
runbook	Step-by-step operational instructions (similar to a manual)	The on-call engineer followed the runbook to resolve the incident.
postmortem	An analysis of an incident or failure	We published an internal postmortem on the outage, including lessons learned.
changelog	A log of changes made to a project	Check the changelog for breaking changes before upgrading the library.
README	An introductory document for a project or repository	Every repo needs a README explaining setup and basic usage.
release notes	Information about a new version (similar to a press release)	The release notes highlight three new features and two bug fixes.

Grammar Tip: Countable vs. Uncountable

'Documentation' is uncountable—say 'the documentation is outdated,' not 'the documentations are outdated.' But 'document' and 'doc' are countable: 'These docs need review.'

Scenario: Writing a Technical Blog Post

Your engineering manager asks you to write a blog post about a recent project. Here's how publishing vocabulary shows up in that conversation:

Manager: 'We want a feature on the observability improvements, not just a short update.'
Editor: 'Can you expand the coverage of the before-and-after metrics?'
Marketing: 'This post could be a supplement to the product launch announcement.'
Manager: 'Our last post on Kubernetes had great circulation—let's aim for similar reach.'

When working with content teams, you may also hear terms like 'draft,' 'revision,' 'byline' (the author's name under the title), and 'deadline' (the date content is due).

Scenario: Reviewing a Colleague's RFC

When reviewing technical documents, you need vocabulary for giving constructive feedback. Here are phrases that use publishing terminology in context:

Weak Feedback (Heard at Work)	Stronger Feedback (Better English)
This part is confusing.	The coverage of the caching strategy could be clearer—can you add a diagram?
You didn't explain enough.	This section would benefit from expanded coverage of failure modes.
I don't get the point.	The editorial voice here is unclear—what's the key takeaway for readers?
Add more stuff about testing.	Could you include a supplement with test scenarios and expected outcomes?
This is too long.	Consider splitting this into a main feature and a supplementary deep-dive.

Culture Note: Giving Feedback in Writing

In asynchronous cultures (remote teams, distributed companies), written feedback on docs is crucial. Being specific and using the right vocabulary makes your comments actionable, not just critical.

Register: Slack vs. Formal Documentation

Technical communication happens across different registers. The vocabulary stays similar, but the tone shifts:

Informal (Slack/Chat)	Formal (Email/Doc)
Hey, can you cover the auth flow in your doc?	Please ensure the document provides adequate coverage of the authentication flow.
I'll add a quick supplement with the metrics.	I will include a supplementary appendix containing the relevant metrics.
The feature on caching looks good 👍	The feature article on caching strategies is well-structured and comprehensive.
This RFC is getting great circulation internally!	The RFC has received significant circulation among engineering stakeholders.
Who's writing the editorial for the launch?	Who will be authoring the editorial perspective for the product launch announcement?

English for Developers Bundle

How to Write and Publish Technical Content in English at Work