Skip to content

Add business-framed Use Cases docs section#356

Merged
ryanechternacht merged 3 commits into
mainfrom
docs/use-cases-section
Jun 12, 2026
Merged

Add business-framed Use Cases docs section#356
ryanechternacht merged 3 commits into
mainfrom
docs/use-cases-section

Conversation

@ryanechternacht

Copy link
Copy Markdown
Member

What

Adds a new Use Cases docs section: a business-outcome-framed layer that lays out the common things teams build with Schematic and links into the existing technical docs and playbooks. Layout inspired by Nango's use-case pages.

Structure

Index (use-cases/overview.mdx) + 11 pages grouped into four categories:

  • Product-Led Growth — Convert and expand users self-serve · Self-service portal · Free trials · Price by usage · Bill for usage · Credit-based billing
  • Sales-Led Growth — Close custom deals
  • Customer Management — Manage exceptions with overrides
  • Operations — Reprice and repackage safely (plan versioning) · Keep Stripe in sync · Automate with webhooks and AI

Each page uses a consistent skeleton: the need (unheadered intro) → Common approachesHow Schematic fits inLearn more. Pages are deliberately light and link out; deeper technical guides are a later pass.

Nav

fern/docs.yml: new Use Cases section inserted after "Using Schematic", and Playbooks moved up to follow it. Playbooks content is unchanged; Use Cases link into it.

Validation

  • fern check: 0 errors. The pre-existing 50 warnings don't reference the new pages.
  • All "Learn more" links verified against live page slugs.

Notes for review

  • Playbooks placement is a judgment call (currently between Use Cases and Quickstart) — easy to move.
  • PLG is intentionally the heavy bucket; Customer Management is lean for now.

🤖 Generated with Claude Code

Adds a new "Use Cases" section that lays out the common things teams
build with Schematic, framed by business outcome (PLG / SLG / Customer
Management / Ops) rather than by primitive. Each page follows a need ->
common approaches -> how Schematic fits in -> learn more skeleton and
links into the existing technical docs and playbooks.

- New index plus 11 use-case pages under fern/docs/pages/use-cases/
- Nav: insert Use Cases after "Using Schematic"; move Playbooks up to follow it

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

Each use-case page now develops the common do-it-yourself approach and
where it breaks down, rather than a single compressed paragraph.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

Rounds out the two lean buckets:
- SLG: Run sales-assisted trials and POCs; Expand accounts with upsells and add-ons
- Customer Management: Spot churn and expansion with usage signals; Stay ahead of renewals and expirations

Wires the four pages into the nav and the Use Cases index.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

@ryanechternacht ryanechternacht merged commit 0af5375 into main Jun 12, 2026
2 checks passed
@ryanechternacht ryanechternacht deleted the docs/use-cases-section branch June 12, 2026 20:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant