Docs or it didn't happen

Sign in Subscribe

Every bucket has a bottom: How to shrink your queue and manage what's left

AI-Generated Apps

Every bucket has a bottom: How to shrink your queue and manage what's left

No one knows how big anyone else's bucket is. Your job is to show them and then build a system that does it for you. This post is part of the Per the docs article series. Links to the rest of the series are at the end of

Unwritten content rules that experienced writers follow

Unwritten content rules that experienced writers follow

So much of a tech writer's knowledge lives in judgment calls, instinctive edits, and choices that you've developed over years of writing for people in real situations. This tacit knowledge is one of the most undervalued things that an experienced technical writer brings to their work.

Per the docs - April 2026

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.

From prompter to builder: a tech writer's guide to MCP and agentic workflows

Career Development

From prompter to builder: a tech writer's guide to MCP and agentic workflows

When I started using AI for technical writing processes, I thought of myself as someone who builds with AI. Turns out I was just a very enthusiastic prompter. Building real agentic processes changed how I think about what technical writers need to learn right now.

Docs-as-code gotchas for technical writers

Docs-as-code gotchas for technical writers

You've made the switch to docs-as-code. Git makes sense. Branches are fine. Then your build fails for no reason. These are the invisible problems that make you question whether you broke something critical, or just don't understand how any of this works.

What to expect when you're expecting docs-as-code

What to expect when you're expecting docs-as-code

Docs-as-code. Version control. Git workflows. Pull requests. CI/CD pipelines. If those terms make your stomach flip, you're not alone. Here's what docs-as-code actually means in practice and what your day will look like as a technical writer.

Git hygiene for technical writers

Git hygiene for technical writers

A former colleague reached out: "Any tips for someone starting a job that does docs as code?" Here's what I learned through trial, error, and years of working with teams at AWS.

I built a job search tracker for you

Job Search Featured

I built a job search tracker for you

Managing job applications is hard. I built a job search dashboard to organize my search, track applications, and improve my strategy. And you can use it too.

Your portfolio is pigeonholing you

Your portfolio is pigeonholing you

Your portfolio might be working against you. Learn how to frame projects around problems you've solved rather than deliverables you've shipped.

About content, tools, and careers

Content Strategy

About content, tools, and careers

Thinking about content as infrastructure, not output. How documentation tools keep evolving, and how careers in content adapt alongside them. Exploring sustainable content systems and the real-world impact of AI-powered tools.