Skip to content

Docs site pivot + reduction + link cleanup (Memo 142) #124

Description

@a6b8

Context

Messaging pivot and reduction pass on the docs site. FlowMCP is positioned as a schema format, not an MCP server; the surface is cut down to what matters; the auto-generated spec/grading/best-practice content is re-synced from the cleaned source.

Changes

Pivot (EN + DE):

  • Hero.astro: headline → "Schema-driven data access for AI agents." (scale moves into the tagline/mission).
  • About: format positioning + value-prop (write the connection once, reuse everywhere; schema kept separate from grading and security), and a Swagger/OpenAPI distinction; the "production-ready" data-source boast is defused.

Generator (AUTOGEN lever):

  • scripts/sync-spec.mjs: drop the visible "Auto-generated" aside from every synced page (provenance stays in frontmatter).

Reduction (default-out, reversible — moved to .trash/, never deleted):

  • Removed FAQ, Use Cases, Schemas & Sources, the guides (Hackathon Kit / Agent Creation / GTFS Pilot), the whole Reference section, and the whole Ecosystem section — plus their German mirrors and the templates that would otherwise regenerate them.
  • Removed the stale route-tests page (a nav-filtered v4.0.0 orphan).
  • astro.config.mjs: removed the matching sidebar groups; repointed ~15 legacy redirects to surviving pages.
  • Fixed all inbound links from surviving pages/components to the removed routes (CLI refs → quickstart, license → spec license page, etc.).

Content:

  • Re-synced the 57 generated spec/grading/best-practice pages from the cleaned source; added lead intros to the concepts pages.

Verification

  • astro build: green, 174 pages.
  • 0 dead links to removed routes; signpost deep-links resolve; no "Auto-generated" asides remain.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions