Per the docs - April 2026
This month's topic brings together technical writers to share their insights on what isn't written - the missing context, the assumed knowledge, and the gaps that cost users the most.
Per the docs is a monthly article series where technical writers explore various aspects of our craft. Each month, a different host curates a topic and brings together diverse voices to share insights, experiences, and practical advice.
Want to follow along or contribute to a future edition? Everything you need is at perthedocs.com: past themes in the archive, contributor guidelines in the writer portal, and information about joining the community.
April 2026 topic: Mind the gap
Where do the docs end and the user's assumption begin? this month, we're exploring what isn't written: missing context, assumed knowledge, and gaps that reduce time-to-success.
Brandi Hopkins
Brandi is a senior documentation strategist who builds scalable content systems, with expertise in docs-as-code workflows, AI-assisted documentation, and developer experience.
Read their post: Auditing the Gaps: A content analysis approach for inherited docs →
James Beach
James is a content strategist and technical writer with a knack for prompt engineering and AI-assisted workflows — always finding new ways to bridge the gap between ideas and execution.
Read their post: Find it to Mind it: Taxonomies as Gap-Finders →
Jill Shaheen
Jill is a documentation leader who's been building content systems, leading documentation teams, and figuring out where infrastructure breaks for nearly 20 years.
Read their post: Unwritten rules that tech writers follow →
Nicholas Galinski
Nick is an M-shaped multidisciplinary writer, content designer, systems architect, and AI-fluid storyteller. Turning complex problems into elegant narratives while leading with empathy.
Read their post: Don't turn off your brain →
Reem Sabawi
Reem is a former AWS technical writer, founder of Reem The Writer, and builder of DocSentinel AI. She writes about documentation strategy and the knowledge layer that makes AI reliable.
Read their post: You are not the show →
Disclaimer: Each article in this series is written and owned by its respective author. The views, opinions, and experiences shared belong solely to the individual writer and do not represent the perspectives of other participants or their employers (past or present).
