How to Write Docs People Read

Docs as Code: The Best Guide for Technical Writers

Recently, my work has involved writing a lot of documentation and. Doing this has introduced me to...

Reader guide · Standard Reader

How to use Standard Reader — following, reading, listening, and making it yours. No technical knowledge needed.

Good Plain English, by Nat Segnit

The problem with writing manuals

afterword

Writing this handbook has been a process of not over-thinking it. In deciding to do it post-by-post, day-by-day, I practiced sharing as I went, posting to a ...

Writing design docs – Ceejbot's notes

How to figure out what to do and tell your colleagues at the same time

Page 4: POW+TREE Writing Strategy

As Ms. Lin reflects on the trouble her students are having with writing, she realizes that many of her students need help incorporating the four elements of the writing process (i.e., planning, organizing, writing, and editing and revising) into their essays. She concludes that they need a guide or strategy to follow as they write.[.....]

Plain language guide series

A series of guides to help you understand and practice writing, designing, and testing plain language.

Creative Reading: Scaffolding Reading for Transformation

However, recent work on augmenting reading largely focuses on making reading more efficient, especially in knowledge-intensive contexts where people must rapidly make sense of research papers and other complex documents (Lo et al., 2024). These systems often aim to help readers skim, summarize, and synthesize large volumes of information in order to reduce cognitive effort and accelerate document- and corpus-level sensemaking at scale (Gu et al., 2025; Lo et al., 2024; Fok et al., 2023). At one extreme, the form of reading implicitly envisioned by these systems may resemble what we call “reading to discard”: extracting the essential, actionable informational core of a document as quickly and efficiently as possible, so that the rest can be swiftly tossed aside—much like we often process inbound mail. This motivates us to ask what scaffolding approaches might resist “reading to discard,” what alternative forms of reading we might scaffold, and what alternative views and values of reading might guide the conversation.

Writing Handbook: How to source writing ideas

Learn how to write an introduction paragraph. This guide explains the writing process for introductions, as well as the process for deciding what to write about.

Guidance on Authoring Lexicons

At last weekend's Atmosphere Conference, there were a lot of questions about how author Lexicons. I thought it would be a good idea to share some guidance.

How To Create An Employee Handbook People Will Actually Want To Read - Fast Company

A handbook doesn't have to read like an instruction manual. Here's how to get employees hooked from page one.

Why good non-techie user documentation is vital for a wider embrace of the ATmosphere - Debbie's Blatherings - by Debbie Ridpath Ohi

Plus tips on writing good user documentation

Connecting with your readers on Semble [Patterns of Sensemaking #2] - Cosmik Labs

On how the references you make help your writing find its natural audience

The revolt of the reader | The Observation Deck

Reading is important to me. While I’m not a quick reader nor an especially voracious one, I have found that long-form reading has had a profound influence on me over my life. And because reading is important to me, writing is too: writing not only allows us to convey our ideas, but the very act forces us to test and distill them — at once making our ideas more robust while providing the vehicle by which to share them.