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 Updated 1.2k repo stars

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. @templates/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 .claude/scripts/check_content_contract.py.

  7. After content edits that should affect chat retrieval, consider devverse-refresh-vectors.

hoangsonww/devverse-swe-blog commit 5aad287054

Frequently asked questions

npx get-skill add hoangsonww/devverse-content-mdx-2