Wiki content management

Current decision

Wiki organization follows the content directories under site/src/content/docs/07-wiki/. A category is one directory deep, a subcategory is two directories deep, and each category or subcategory has an index.md or index.mdx file. The generated wiki index derives navigation from that hierarchy.

Authenticated editors manage the hierarchy from the Wiki Index:

• + Category and + Subcategory add index files to the shared draft branch.
• Dragging an article card to another panel moves its Markdown source file to that directory.
• The remove control deletes an empty category or subcategory. Editors must move or delete its contents first.
• Taxonomy changes become permanent navigation after the shared drafts are published and the site rebuilds.

Article titles and Markdown frontmatter remain unchanged when an article moves. Its URL changes to match its new directory.

Article reference images

Reference metadata remains in site/src/data/reference-images.json. At build time, an article displays every reference whose tags contain the article title, an alias, or a value in its optional imageTags frontmatter array. Matching is case-insensitive and requires the complete tag value to match; partial title matches do not attach an image accidentally.

See Uploading and Tagging References for the upload workflow and metadata format.