How we review content
Every guide on Blackbox Atlas is validated by an automated compiler gate before it is published. No guide reaches production without passing strict checks. This page explains how we ensure consistency and quality.
Validation rules
Each guide must have: a non-empty title and description, 3–7 quick-answer bullets, step
count by intent (how-to 6+, troubleshooting 8+, checklist 10+, decision 7+), valid topic and
intent, difficulty, and a last-reviewed date. Next links: 2–5 slugs, at least one to a
troubleshooting or checklist guide. Prerequisites: 0 or 1. Rules are defined in
src/config/GUIDE_RULES.json and enforced by the validator.
Publishing policy
We block guides that involve hazardous activities (e.g. gas pilot relight, electrical panel work) or that give medical or legal advice. Guides that require professional help must include clear escalation language (e.g. "call a licensed plumber"). We do not publish content that bypasses safety devices or encourages risky behavior.
Guide status
Guides have one of three statuses: draft (work in progress, not visible in production), review (fails validation, not visible in production), or approved (passes validation, published). Status is set automatically by the autopromote script—there is no manual approval step. Only approved guides appear on the site.
Frequently asked questions
- What are the validation rules for guides?
- Each guide must have: a non-empty title and description, 3–7 quick-answer bullets, step count by intent (how-to 6+, troubleshooting 8+, checklist 10+, decision 7+), valid topic and intent, difficulty, and last-reviewed date. Next: 2–5 links, at least one to troubleshooting or checklist. Prerequisites: 0 or 1.
- What is the publishing policy?
- We block guides that involve hazardous activities (e.g. gas pilot relight, electrical panel work) or that give medical or legal advice. Guides that require professional help must include clear escalation language (e.g. "call a licensed plumber").
- What are the guide statuses?
- Guides have one of three statuses: draft (work in progress), review (fails validation), or approved (passes validation, published). Only approved guides appear on the site.