glow/first-home-diy
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Content infrastructure: Add article templates and required H2 schemas to brief workflow #50

New issue
Closed
opened 2026-06-09 20:48:09 +00:00 by glow · 1 comment
glow commented 2026-06-09 20:48:09 +00:00
Owner
Copy link

Problem

Articles are written without a consistent structure template, leading to:

  • Some articles missing cost comparison tables
  • Inconsistent callout usage
  • Missing required sections
  • Validator can't check for missing sections without brief

Suggested fix

  1. Create canonical article templates for each article type:
    • Repair guide: Symptoms → Diagnosis → Tools/Parts → Step-by-step → Cost breakdown → When to call a pro → FAQ
    • Decision guide: Scenario → Pros/Cons → Cost comparison → Decision framework → FAQ
    • Checklist: Ordered list with time estimates per task → Seasonal context → FAQ
  2. Add required H2 sections to all briefs
  3. Enforce through the validator

Priority

Medium — enables faster, more consistent article production from the 865-brief backlog.

## Problem Articles are written without a consistent structure template, leading to: - Some articles missing cost comparison tables - Inconsistent callout usage - Missing required sections - Validator can't check for missing sections without brief ## Suggested fix 1. Create canonical article templates for each article type: - **Repair guide**: Symptoms → Diagnosis → Tools/Parts → Step-by-step → Cost breakdown → When to call a pro → FAQ - **Decision guide**: Scenario → Pros/Cons → Cost comparison → Decision framework → FAQ - **Checklist**: Ordered list with time estimates per task → Seasonal context → FAQ 2. Add required H2 sections to all briefs 3. Enforce through the validator ## Priority Medium — enables faster, more consistent article production from the 865-brief backlog.
glow self-assigned this 2026-06-09 20:48:09 +00:00
glow closed this issue 2026-06-09 21:54:35 +00:00
glow commented 2026-06-09 21:54:41 +00:00
Author
Owner
Copy link

Created 3 canonical article templates in /briefs/:

TEMPLATE-repair.md — Repair guide template. Symptoms, diagnosis, step-by-step, cost breakdown (DIY vs Pro), when to call a pro, FAQ. Incorporates #47 cost comparison requirements.

TEMPLATE-decision.md — Decision guide template (DIY vs Pro, What to Buy). Short answer, scenario breakdown, cost comparison table, time comparison, skill level, FAQ. Pillars: pro-vs-diy or buyer-prep. 1200-1800 words.

TEMPLATE-guide.md — Guide/checklist template. Overview, main content, key takeaways, related resources, FAQ. Optional checklist table. 1000-1500 words.

All committed in 875e2e1.

Closes #50.

Created 3 canonical article templates in /briefs/: **TEMPLATE-repair.md** — Repair guide template. Symptoms, diagnosis, step-by-step, cost breakdown (DIY vs Pro), when to call a pro, FAQ. Incorporates #47 cost comparison requirements. **TEMPLATE-decision.md** — Decision guide template (DIY vs Pro, What to Buy). Short answer, scenario breakdown, cost comparison table, time comparison, skill level, FAQ. Pillars: pro-vs-diy or buyer-prep. 1200-1800 words. **TEMPLATE-guide.md** — Guide/checklist template. Overview, main content, key takeaways, related resources, FAQ. Optional checklist table. 1000-1500 words. All committed in 875e2e1. Closes #50.
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
No results found.
Labels
Clear labels   
bug
Bug fix

  
feature
New feature

  
improvement
Code improvements and refactors

No labels
bug
feature
improvement
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
glow
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
glow/first-home-diy#50
No description provided.