Skip to content

Epic 17 — R1 Documentation & Marketing #148

Description

@fupelaqu

Epic 17 — R1 Documentation & Marketing

Ship the launch-day documentation + marketing surface for R1. Eight content surfaces across the two doc repos — softclient4es-web (Astro/Starlight, canonical) and elasticsql (documentation/ Markdown mirror, per feedback_dual_docs_sync). Docs/marketing only — no production code.

Implemented via dependency-scheduled, per-story worktrees off release-r1; each story has its own draft PR per repo targeting release-r1.

Stories & PRs

Story Surface web issue/PR elasticsql issue/PR
17.1 JOIN matrix walkthrough (R1 centerpiece) #11 / #12 #135 / #137
17.2 Multi-cluster federation operator guide #16 / #8 (extends feature/16.6) #140 / #124 (extends feature/16.6)
17.3 Single-cluster quickstarts (JDBC/ADBC/Flight SQL) #20 / #21 #144 / #145
17.4 BI-tool integration guides #18 / #19 #142 / #143
17.5 Licensing matrix + pricing communication #22 / #23 #146 / #147
17.6 Honest BI-tool gap framing (known-limitations) #15 / #17 #139 / #141
17.7 Privacy + telemetry doc #13 / #14 #136 / #138
17.8 Landing page + R1 blog series + LinkedIn cadence (this run) (this run)

Epic-close launch gate (pending-link sweep — must be clean before R1)

Each story forward-declared cross-links to not-yet-merged sibling pages with visible pending markers (the per-story worktrees branch off release-r1, so a sibling's NEW page is only on its own unmerged branch). All pending markers and any bare 404 route MUST be wired live (or removed) once the sibling PRs merge onto release-r1. Story 17.8 owns the final launch-gate verification. Targets that resolve at merge: /sql/joins/ (17.1), /known-limitations/ (17.6), /integrations/federation-helm/ (16.6/17.2), /integrations/{adbc,tableau,power-bi,metabase}/ (17.3/17.4). /privacy/telemetry/ is already live on release-r1.

Follow-ups routed to release process (not docs stories)

  • <R1_DRIVER_VERSION> literal placeholder ships across the quickstart + BI pages (17.3/17.4); the published R1 driver-JAR tag is a single find/replace at release time (4-way version drift 0.1.4/0.1.5/0.2.0/0.20.0).
  • BI-tool screenshots (17.4) ship as labelled placeholders (no Tableau/Power BI installs at dev time) — real captures are an R1.x refresh item.
  • Doc version badge placement (17.8 AC17) before R1.

🤖 Generated with Claude Code

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    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