Keywords & IA
A Sealed Keyword Taxonomy
A single Keywords collection with an immutable machine key and a three-value category drives the rendered descriptor pills, the search corpus, and the landing's information architecture — with a CSV that stays authoritative in both directions.
- Platform
- Product Engineering
- Frontend
- Information Architecture
- Search
- Headless CMS
- System Design
- PostgreSQL
Overview
Every portfolio and experience item needs tags — for the visitor to read ("React, Design Systems") and for search to recall. The naïve version sprawls fast: tech tags vs. skill tags vs. hidden recruiter terms as separate fields or collections, a slug per keyword, synonyms sprayed everywhere until search returns a wall of half-matches that reads as self-promotion.
The model here is sealed: one collection, one immutable key, one three-value category (scope / craft / searchOnly). The same keyword can be a rendered pill or a hidden recall term depending only on its category — there's no second mechanism. The hardest-won decision is a discipline, not a feature: hidden recall terms are kept deliberately disjoint from the visible content vocabulary, so a query lands one clean high-salience hit instead of a per-term explosion.
The IA half is the landing page's section manifest living in the CMS, where each section's anchor, nav label, and searchability derive from one record — and a {years} token lets experience copy stay editorial while the code supplies only the figure.