Write for One Person
Summary
A comic from the wizardzines archive that advises writing for a single person, aimed at developers and technical communicators.
View Cached Full Text
Cached at: 06/15/26, 12:56 AM
Similar Articles
@johnnyheo: Fable and Sol tend to use a lot of jargon that's hard to understand on a first read, which slows me down a lot i've fou…
Johnny Heo shares a tip for improving user-facing explanations by adding a style rule to agent or Claude.md files to write clearly without jargon, and setting personality to none in .codex/config.toml.
In what way if any are you a tech minimalist while maintaining your job/love for tech?
A discussion on lobste.rs where tech workers share their practices of tech minimalism, such as avoiding smart home devices, using pen and paper, and writing custom software.
“Everyone is building the same thing, funded by the same people, using the same words.”
A reflective essay on tech monoculture and the value of 'useless' research, centered around the author's hands-on experience with Folk Computer, an open-source physical computing system that reimagines programming as a collaborative, spatial activity.
Please keep code descriptions simple
A developer argues that code descriptions, commit messages, and merge request descriptions should be kept simple and focus on explaining why changes were made, not what, to improve accessibility for reviewers with attention difficulties.
Are you writing code self or letting agents do that and how to get good UI
Explores the trade-offs between writing code manually versus using AI agents, and offers advice on achieving good UI design.