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

Content infrastructure: Improve inter-article linking strategy #52

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

Problem

Article related slugs reference existing articles, but there's no systematic cross-linking strategy. Internal links are placed inconsistently and don't form topical clusters.

Suggested fix

  1. For each new article, define 3-5 internal links within the body prose (not just the related footer)
  2. After publishing, link back from older relevant articles
  3. Create hub pages per pillar that link to all articles in that cluster
  4. Consider a "toolkit required for this job" box that links to tool guides

Priority

Low effort, medium impact — simple internal linking pattern.

## Problem Article `related` slugs reference existing articles, but there's no systematic cross-linking strategy. Internal links are placed inconsistently and don't form topical clusters. ## Suggested fix 1. For each new article, define 3-5 internal links within the body prose (not just the related footer) 2. After publishing, link back from older relevant articles 3. Create hub pages per pillar that link to all articles in that cluster 4. Consider a "toolkit required for this job" box that links to tool guides ## Priority Low effort, medium impact — simple internal linking pattern.
glow self-assigned this 2026-06-09 20:48:10 +00:00
glow closed this issue 2026-06-09 21:57:43 +00:00
glow commented 2026-06-09 21:57:49 +00:00
Author
Owner
Copy link

Created scripts/audit-links.ts — full internal link audit tool.

Key findings:

  • Orphans (0 inbound): how-to-fix-a-stuck-door, how-to-replace-an-electrical-outlet
  • Dead-ends (0 outbound): 4 articles including breaker-keeps-tripping, how-to-fix-a-leaky-faucet
  • Most-linked: leaky faucet (7 inbound), breaker/ceiling-fan/pro-vs-diy (6 each)
  • Pillar density: repairs cluster at 22.2% density, 65% stay within pillar
  • Broken links: 9 pillar-based paths in breaker-keeps-tripping that dont resolve

Added package.json audit:links script. Run with bun run audit:links.

Closes #52

Created scripts/audit-links.ts — full internal link audit tool. **Key findings:** - **Orphans** (0 inbound): how-to-fix-a-stuck-door, how-to-replace-an-electrical-outlet - **Dead-ends** (0 outbound): 4 articles including breaker-keeps-tripping, how-to-fix-a-leaky-faucet - **Most-linked**: leaky faucet (7 inbound), breaker/ceiling-fan/pro-vs-diy (6 each) - **Pillar density**: repairs cluster at 22.2% density, 65% stay within pillar - **Broken links**: 9 pillar-based paths in breaker-keeps-tripping that dont resolve Added package.json `audit:links` script. Run with `bun run audit:links`. Closes #52
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#52
No description provided.