Structure

Category descriptions are structural metadata, not decoration

Most category descriptions are written after the fact

You build your taxonomy, label a few categories, publish some posts, and then someone asks what the category page should say. So you write a paragraph that vaguely summarizes everything you've already published there. That's backwards. The description should define the boundary before you assign anything to the category.

If you can't articulate what belongs—and what doesn't—you haven't actually created a category. You've created a label that drifts with whatever you feel like tagging next.

Write the description when you create the category

Two sentences. First sentence: what this category covers. Second sentence: what it excludes or how it differs from the adjacent category. If you can't write both sentences without handwaving, stop. You don't need this category yet.

Example for a "production" category: Advice for managing the recurring work of publishing: CMS workflows, scheduling, and repeatable habits. Does not cover writing technique or information architecture decisions.

That's enough. You've drawn a line. Now when you're tagging a post about field labels, you know it's a production post because it's about CMS workflow, not writing. When you're tagging a post about homepage structure, you know it's not production because it's an IA decision.

Descriptions guide assignment, not just readers

The real audience for your category description isn't the person landing on the category page. It's you, six months from now, trying to remember why "process" and "production" are supposed to be different. Or your colleague who's about to tag a post and needs to know which category fits.

If your descriptions are decorative—"Explore our best thinking on production topics!"—they're not doing the structural work. They're not helping anyone decide where a post belongs. They're just taking up space on a category landing page that probably needs better navigation anyway.

Test the description by tagging backwards

Pick five posts you've already published. Read only the category description—not the posts, not your memory of what you meant when you tagged them. Can you predict which category each post belongs to based solely on the two-sentence description? If not, rewrite the description or rethink the category.

This is the same discipline as taxonomy naming: if you can't explain the difference, the difference doesn't exist. A category without a falsifiable description is just a bucket you throw things into when you're not sure.

Structural metadata prevents taxonomy drift

Taxonomies expand over time. You add categories because a new content type doesn't fit the old ones. Fine. But if your category descriptions are vague or missing, every new category is just a guess. You're building a structure on top of a structure you never defined.

Write the description first. Make it specific enough that you could hand it to someone else and they'd tag the same posts you would. That's the test. If the description passes, the category is real.

← All posts