New Features
4 new additions
-
Relationship tables (
reltable) — opt-in DITA-style relationship table atcontent/reltable.yml. Define related-topic groupings once using the five topic types (overview,concept,task,reference,troubleshooting), and the build pipeline emits a per-slug lookup that the new<RelatedTopics />component consumes. Familiar to anyone with a structured-authoring background, ideal for maintaining bidirectional related links without editing every page -
<RelatedTopics />component — globally registered MDX component that auto-detects the current page, renders grouped "Related topics" sections in the order overview → concept → task → reference → troubleshooting, and hides empty sections gracefully. Props:title,slug(override), andshowTypes(filter columns) -
scripts/build-reltable.js— build step that readscontent/reltable.yml, resolves each slug againstcontent/docs/, warns on unresolved refs without failing the build, and emitspublic/reltable.jsonkeyed bylocale:version. Wired intonpm run build. Missingreltable.ymlis a silent no-op so the feature stays fully opt-in -
Scaffolder template updates — new projects include a commented-out
content/reltable.ymlstub, theRelatedTopicscomponent, and the build script pre-wired into thebuildscript
Improvements
1 enhancements
- Components documentation — added RelatedTopics guide covering the schema, authoring rules, multi-family examples, props, and i18n/versioning behavior. Components index and
features.mdxupdated to list the new component