Devverse Content Mdx

MDX article conventions for DevVerse. Use when adding or editing files under content/, changing article metadata, updating author or date lines, or modifying code that parses article content for feeds, related posts, reading stats, or RAG ingestion.

hoangsonww d2ebac5 4 files · 2.8 KB Updated

File contents

DevVerse MDX Content Workflow

  1. Treat content/*.mdx as the canonical article store. Do not model article changes around supabase/articles.sql; runtime content comes from MDX files.

  2. Keep the article contract stable. Use a literal export const metadata = { title, description, topics };, keep ### Author: ..., keep > Date: YYYY-MM-DD, and keep the article body starting with a top-level # heading.

  3. Use the checked-in template when creating a new article. @assets/article-template.mdx

  4. Read the contract notes before changing metadata conventions. @references/article-contract.md

  5. If you change metadata shape or article template rules, update every dependent parser in the same task.

  6. After content edits, run python3 scripts/check_content_contract.py.

  7. If chat retrieval quality should reflect the change immediately, consider devverse-refresh-vectors.

hoangsonww/devverse-swe-blog/tree/main/.agents/skills/devverse-content-mdx commit d2ebac5232

Frequently asked questions

npx skillmds@latest add hoangsonww/devverse-content-mdx