Skip to content

Conversation

@dmarticus
Copy link
Contributor

@dmarticus dmarticus commented Jan 27, 2026

Changes

Built a new docs experience for feature flags, inspired by error tracking. Key changes:

New "Start here" page (/docs/feature-flags/start-here)

  • Quest-log style guided walkthrough for getting started with feature flags (a la error tracking)
  • Covers: creating first flag, adding code, testing/rollout, experiments integration, and pricing

Restructured navigation

  • Added section headers: "Getting started", "Concepts", "Guides", "Resources"
  • Promoted key guides to the sidebar (phased rollout, canary release, targeting groups, remote config, dependencies, early access, scheduled changes)
  • Moved tutorials from /tutorials/ to /docs/feature-flags/ for better discoverability:
    • phased-rollout.md
    • canary-release.md
    • group-page-machine-flags.mdtargeting-groups.md

Revamped overview page (/docs/feature-flags)

  • Added overview section explaining common use cases (phased rollouts, kill switches, targeting, A/B testing, remote config, beta programs)
  • Added SDK/framework grid using existing installation platforms component
  • Added feature comparison table showing all flag capabilities
  • Added "PostHog ecosystem" section showing integrations with experiments, session replay, analytics, error tracking, surveys, and data warehouse
  • Simplified "Next steps" to three key resources

Other updates

  • Simplified installation index page to just show platform picker
  • Added redirects for moved tutorial pages
  • Updated internal links to point to new locations

Checklist

@vercel
Copy link

vercel bot commented Jan 27, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Review Updated (UTC)
posthog Ready Ready Preview Jan 28, 2026 8:22pm

Request Review

@dmarticus dmarticus requested review from a team and gewenyu99 January 28, 2026 17:48
@dmarticus dmarticus marked this pull request as ready for review January 28, 2026 17:48
@dmarticus dmarticus requested a review from edwinyjlim January 28, 2026 17:54
@edwinyjlim edwinyjlim requested a review from a team January 28, 2026 17:59
@edwinyjlim
Copy link
Member

can always tag @PostHog/team-docs-wizard btw!

Copy link
Member

@edwinyjlim edwinyjlim left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

looks really clean!

y'all are one of the best product teams when it comes to writing and creating documentation, so the reorganizing looks great here

- First 1M API requests per month are free
- Above 1M we have usage-based pricing with volume discounts
- Set billing limits to avoid surprise charges
- See our [pricing page](/docs/feature-flags/cutting-costs) for details
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

in the cutting-costs.mdx page, could you add the single product calculator component at the top? to flex our transparency 💪

it pulls in the calculator from the official /pricing page with filters

import Pricing from 'components/Pricing/PricingCalculator/SingleProduct.tsx'

<Pricing productType="feature_flags" />

Looks like this:

Image

@edwinyjlim
Copy link
Member

@dmarticus i'll also make a dashboard for you guys. we've seen a ~1.5-2x increase in docs-to-product conversions with these new pages and structure for error tracking and LLMA

@dmarticus dmarticus merged commit 4bc8f2c into master Jan 28, 2026
15 checks passed
@dmarticus dmarticus deleted the chore/update-docs branch January 28, 2026 20:32
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.

3 participants