marketing: content updates

Merged
KI
3mo ago
+6930-38

Content and tooling updates for the marketing site.


Summary by cubic

Adds two category guides at /parallel-coding-agents and /agent-orchestration with Markdown twins, wires them into sitemap/footer/homepage, and enforces Vale prose linting in CI. Also polishes copy across posts and comparisons, adds diagrams/screenshots, and sets JSON‑LD dateModified from lastUpdated.

  • Pages: /parallel-coding-agents(.md) and /agent-orchestration(.md) render correct content and metadata with updated JSON‑LD; Accept: text/markdown on these routes serves category content via /md/category/*.

  • SEO/navigation: category guides appear in /sitemap.xml (priority 0.9); footer adds “Parallel agents guide” and “Orchestration guide”; homepage shows a Guides section.

  • Content: new comparisons (superset-vs-augment-intent, superset-vs-parallel-code, superset-vs-zed), roundup updates, added diagrams under /public/images/guides and product shots across guides/compare pages, FAQ expands with an open‑source item, team page copy expanded.

  • Required: when adding a new guide, update CATEGORY_SLUGS in apps/marketing/src/proxy.ts so .md twins and Accept: text/markdown resolve.

  • CI: a “Vale prose lint” job runs on ubuntu‑latest and fails on style errors; run bun run lint:prose in apps/marketing locally before committing.

Summary by CodeRabbit

  • New Features

    • Added guides on AI agent orchestration and parallel coding agents.
    • Added comparison pages for additional coding-agent tools.
    • Added marketing pages, navigation links, FAQs, sitemap entries, and Markdown access for the new guides.
    • Expanded company and product information across marketing resources.
    • Added diagrams and illustrations explaining parallel workflows and worktree isolation.
  • Documentation

    • Refined existing articles, comparisons, and changelog wording.
    • Added copywriting guidance and readability standards.
  • Chores

    • Added automated prose-quality checks for clarity, consistency, inclusivity, and terminology.