Playbook Technical Writing Docs Overhaul

---
name: playbook-technical-writing-docs-overhaul
description: "Sorted page types, working pipelines, and freshness signals readers trust again."
---
# Playbook: Overhaul a neglected docs site

> Sorted page types, working pipelines, and freshness signals readers trust again.

**Track:** 🗺️ Technical Writing · **Domain:** Journey Playbooks · **Level:** journey · **~80 min**

**Who this is for:** Technical Writers, Developer Advocates, Engineers Who Document, Content Leads

## When to Use This Skill

Sorted page types, working pipelines, and freshness signals readers trust again.
Use it whenever a matching task appears in conversation — the agent loads these instructions on demand.

## Journey Steps

1. Step 1 — Sort docs into types readers recognize: start with "Label every existing page: learning-journey, task-recipe, information-lookup, or theory"
2. Step 2 — Run docs through the same pipeline as code: start with "Store docs beside code or in sibling repo with same review gates"
3. Step 3 — Write changelogs users read: start with "Categorize: Added / Changed / Fixed / Breaking / Security only"
4. How it fits together: Sort types before rewriting anything. Half the mess resolves itself once modes separate.

### Referenced Skills

- `docs-systems-diataxis-audit`
- `docs-systems-docs-as-code-workflow`
- `dev-content-changelog-users-read`

## Commands

**Install all referenced skills**
```bash
npx skills add aniruddhaadak80/skills --skill docs-systems-diataxis-audit && npx skills add aniruddhaadak80/skills --skill docs-systems-docs-as-code-workflow && npx skills add aniruddhaadak80/skills --skill dev-content-changelog-users-read
```

---

Part of [aniruddhaadak80/skills](https://github.com/aniruddhaadak80/skills) · Browse all at https://skills.sh/aniruddhaadak80/skills