Docs CLAUDE.md

Style Guide

  • Titles must be phrased as questions — e.g., “How do I make a feed from a webpage?”, “How does iCloud sync work?”
  • Titles go in the title field in frontmatter. They are rendered as the page <title> and appear in the docs index.
  • Docs live in two sections: manual/ (how to use specific features) and guides/ (broader concepts and workflows).
  • Include a description in frontmatter — a single sentence summarizing the page, used in the docs index listing.
  • Include a sidebar in frontmatter — a short, active label for the sidebar navigation (e.g., “Add RSS feeds”, “Group content by post”). Falls back to title if omitted.
  • Follow the writing style in website/CLAUDE.md — use <kbd> for UI elements, “tap” not “click”, second person, present tense.