Content Architecture

Content Architecture

This document defines taxonomy and linking rules to keep content discoverable before and after Chirpy migration.

Taxonomy Model

• Use category as the primary taxonomy key (single value).
• Keep categories for legacy compatibility only when needed.
• Keep tags focused and short.

Canonical Categories

Allowed primary values for category are listed in categories.txt:

• ai
• angular
• java
• spring
• sencha
• pt-br
• javascript
• typescript
• copilot

Tag Normalization Rules

• Prefer lowercase tags.
• Prefer hyphenated tokens for multi-word tags.
• Avoid duplicate variants like ExtJS, ext js, extjs in new content.
• Recommended range: 3 to 6 tags per post.

Internal Linking Rules

For new posts:

1. Add at least 2 internal links to related posts from the first half of the article.
2. Add at least 1 internal link in the conclusion or references section.
3. Link to the archive page when no close post match exists.

For templates:

• post layout includes a related posts block.
• Related posts prefer shared category, then shared tags, then recent fallback.

Maintenance Cadence

• Monthly (first week):
  • review latest posts for taxonomy consistency.
  • normalize obvious tag duplicates.
• Quarterly:
  • audit category distribution and rebalance overused tags.
  • review related-post quality on the 10 latest posts.
• Pre-migration checkpoint:
  • ensure each post has a valid category.
  • ensure new posts follow canonical category set.