Skip to content

Handbook: split releases and launches#18128

Draft
charlescook-ph wants to merge 3 commits into
masterfrom
posthog-code/handbook-releases-vs-launches
Draft

Handbook: split releases and launches#18128
charlescook-ph wants to merge 3 commits into
masterfrom
posthog-code/handbook-releases-vs-launches

Conversation

@charlescook-ph

Copy link
Copy Markdown
Collaborator

Changes

Reframes the marketing product announcements handbook page around the outcome of the recent launch retro. Two additions near the top of the page:

  • Releases vs. launches — a clear split of ownership. Releases are product-owned and aimed at existing users; launches are marketing-owned (product marketer leading) and aimed at reaching new people. Plus guidance that the two line up where certainty allows, and that a launch can trail a release when pricing/features/naming aren't locked yet.
  • How we launch: rolling, not big bang — documents our deliberate choice to favor a rolling approach over single big-bang moments, with the reasoning (small teams, real reach/depth numbers over X vibes).

Everything else on the page (announcement types, launch best practices, maintenance and incident comms) is unchanged.

Why: The retro found that "launch" was being used to mean several different things, and expectations of who owns what varied between product and marketing. This writes down the releases/launches split we're trying out so it's clear and shared.

Checklist

  • I've read the docs and/or content style guides.
  • Words are spelled using American English
  • Use relative URLs for internal links
  • I've checked the pages added or changed in the Vercel preview build
  • If I moved a page, I added a redirect in vercel.json (n/a — no page moved)

Created with PostHog from a Slack thread

Reframes the product announcements page around the releases-vs-launches distinction from the recent launch retro: releases are product-owned (existing users), launches are marketing-owned (new people), and they line up where certainty allows. Also documents our deliberate rolling-not-big-bang launch philosophy.

Generated-By: PostHog Code
Task-Id: c5837b0f-5624-49d5-aec7-ca63c318314d
@github-actions

github-actions Bot commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Jul 02, 2026 12:29PM

@github-actions

github-actions Bot commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

Vale prose linter → found 0 errors, 7 warnings, 0 suggestions in your markdown

Full report → Copy the linter results into an LLM to batch-fix issues.

Linter being weird? Update the rules!

contents/handbook/marketing/product-announcements.md — 0 errors, 7 warnings, 0 suggestions
Line Severity Message Rule
11:4 warning 'Releases vs. launches' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
19:10 warning Use the Oxford comma before 'and' or 'or' in a list of three or more items. PostHogBase.OxfordComma
61:46 warning Capitalize 'Surveys' for PostHog's product. Use 'surveys' for the general industry concept. PostHogBase.ProductNames
78:1 warning 'Comms' is a possible misspelling. PostHogBase.Spelling
100:12 warning Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. PostHogBase.ProductNames
100:30 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
108:177 warning 'comms' is a possible misspelling. PostHogBase.Spelling

@charlescook-ph

Copy link
Copy Markdown
Collaborator Author

@annikaschmid maybe you can paste the update release + launch checklist in here when you get a chance and we can work off this page as source of truth?

Replace spaced hyphens and em dashes with en dashes ( – ) in the new releases-vs-launches sections to satisfy the PostHogBase.EnDash prose rule flagged by the Vale linter.

Generated-By: PostHog Code
Task-Id: c5837b0f-5624-49d5-aec7-ca63c318314d
@github-actions

github-actions Bot commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

Bundle report

Total JS (gzip)

6.29 MiB (no change)

Eager graph (static-import closure per entrypoint)

Entrypoint Eager size Budget Modules
app 24.21 MiB (no change) report-only 5516
Largest modules in the app closure
Module Size
css ./node_modules/.pnpm/css-loader@5.2.7_webpack@5.101.3/node_modules/css-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[1]!./node_modules/.pnpm/postcss-loader@4.3.0_postcss@8.5.6_webpack@5.101.3/node_modules/postcss-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[2]!./src/styles/global.css 708.0 KiB
./src/components/Stickers/Stickers.tsx 696.4 KiB
./.cache/caches/gatsby-plugin-mdx/mdx-scopes-dir/31a094f140f119e73085d847ae81b99b.js + 2 modules 579.3 KiB
./node_modules/.pnpm/@radix-ui+react-icons@1.3.2_react@18.3.1/node_modules/@radix-ui/react-icons/dist/react-icons.esm.js 481.4 KiB
./node_modules/.pnpm/@codemirror+view@6.38.2/node_modules/@codemirror/view/dist/index.js 458.1 KiB
./node_modules/.pnpm/rehype-raw@7.0.0/node_modules/rehype-raw/lib/index.js + 29 modules 395.1 KiB
./node_modules/.pnpm/@posthog+icons@0.36.6_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@posthog/icons/dist/posthog-icons.cjs.js 364.8 KiB
./node_modules/.pnpm/@posthog+icons@0.36.6_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@posthog/icons/dist/posthog-icons.es.js 354.8 KiB
./src/hooks/useCustomers.tsx + 54 modules 353.9 KiB
./node_modules/.pnpm/react-markdown@8.0.7_@types+react@16.14.66_react@18.3.1/node_modules/react-markdown/lib/react-markdown.js + 88 modules 351.4 KiB
./node_modules/.pnpm/cloudinary-core@2.14.0_lodash@4.17.21/node_modules/cloudinary-core/cloudinary-core.js 281.9 KiB
./src/components/ProductComparisonTable/index.tsx + 116 modules 267.6 KiB
./node_modules/.pnpm/@codesandbox+sandpack-react@2.20.0_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@codesandbox/sandpack-react/dist/index.mjs 266.6 KiB
./node_modules/.pnpm/d3@7.9.0/node_modules/d3/src/index.js + 208 modules 247.4 KiB
./src/components/Pricing/PricingSlider/Slider.tsx + 87 modules 239.9 KiB

Eager-graph budgets are report-only until a baseline is established. Sizes are gzip of public/**/*.js; eager size is webpack module source bytes.

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