Repository navigation
feat(warehouse): add a Learn tab with the data stack quick questions - #21399
Conversation
Move /context-warehouse/warehouse to ProductReaderView with the same sections as other product pages. The warehouse is a sales-led beta, so the hero and closing section send people to sales instead of signup. Copy is aligned with the warehouse docs, and the feature comparison is checked against BigQuery, Snowflake, and Redshift docs. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01V9JmPnzu6DFbzWDyi53Vxo
…products menu - Move src/pages/context-warehouse/warehouse.tsx to src/pages/warehouse.tsx - Redirect /context-warehouse/warehouse to /warehouse - Point existing links and redirects at /warehouse - Add Warehouse after Tracing in the products menu Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Deploy preview
|
Bundle reportTotal JS (gzip)10.43 MiB (+30.8 KiB / +0.3%) Largest changed named chunks
Eager graph (modules shipped in each entrypoint's initial chunks)
Largest modules in the
|
| Module | Size |
|---|---|
./src/data/mcp-tools.json |
1423.2 KiB |
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 |
825.0 KiB |
./src/components/Stickers/Stickers.tsx |
696.4 KiB |
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/x-ray.mjs |
481.2 KiB |
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/trenchcoat.mjs |
450.8 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+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/im-the-driver.mjs |
385.8 KiB |
./src/hooks/useCustomers.tsx + 59 modules |
380.8 KiB |
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/tourist.mjs |
364.6 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 |
./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 |
./src/components/ProductComparisonTable/index.tsx + 130 modules |
311.4 KiB |
./node_modules/.pnpm/framer-motion@14.0.0_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/framer-motion/dist/es/render/components/motion/proxy.mjs + 127 modules |
287.8 KiB |
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/doll-house.mjs |
284.1 KiB |
./node_modules/.pnpm/cloudinary-core@2.14.0_lodash@4.17.21/node_modules/cloudinary-core/cloudinary-core.js |
281.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 for the modules actually shipped in the entrypoint's initial chunks (post-tree-shake).
This PR may affect SEO/AEO@natalia-amorim, please review the items below before this PR merges. If Natalia is out, ask Ian or Andy to review instead. 🔍 Worth a look (1)
This comment updates on each push. The check reads the diff only, so it can miss problems or flag safe changes. If this is a false alarm, reply here so the check can improve. |
…ino engine Say in the hero and "What does it do?" that the Warehouse is a real database with its own hostname, credentials, and storage. Add a "BI & notebooks" slide to "How do I use it?". Replace the DuckDB and Postgres wire content on the query engine and storage slides with PostHog's fork of Trino. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…l time Add a "Events in near real time" row to the feature comparison. On US Cloud, new events land in the Warehouse within minutes of capture. EU Cloud does not stream events yet, so the PostHog cell says "US Cloud". Correct the Sources slide, which said that events update daily. Events arrive within minutes on US Cloud. Persons update daily. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… as unsupported - Remove the "Data management" and "Governance" sections - Show machine learning in the warehouse as not supported for PostHog Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…oduct-page # Conflicts: # src/pages/context-warehouse/warehouse.tsx
3662f43 to
4a248b1
Compare
- Link the Data Stack pocket guide to the Warehouse product, so Warehouse gets a Learn tab at /learn/warehouse and the guide moves to /learn/warehouse/pocket-guide - Add optional pocketGuideSection and learnNavFullTitles to product data. The Warehouse Learn tab lists only the "Ask a quick question" chapters, labeled with their questions - Redirect /docs/data-warehouse/pocket-guide and point the /pocket-guides redirects at the new URL - Replace the docs sidebar chapter list with one link to the Learn tab - Update links and the Learn route tests Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
4a248b1 to
bf4b54a
Compare
|
Vale prose linter → found 1 errors, 21 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!
|
| Line | Severity | Message | Rule |
|---|---|---|---|
| 50:10 | warning | 'rollout's' is a possible misspelling. | PostHogBase.Spelling |
contents/learn/data-stack/pocket-guide/feature-revenue-impact/index.mdx — 0 errors, 1 warnings, 0 suggestions
| Line | Severity | Message | Rule |
|---|---|---|---|
| 31:26 | warning | 'rollout's' is a possible misspelling. | PostHogBase.Spelling |
contents/learn/data-stack/pocket-guide/features-drive-revenue/index.mdx — 0 errors, 1 warnings, 0 suggestions
| Line | Severity | Message | Rule |
|---|---|---|---|
| 50:12 | warning | 'rollout's' is a possible misspelling. | PostHogBase.Spelling |
contents/learn/data-stack/pocket-guide/lead-scoring/index.mdx — 0 errors, 2 warnings, 0 suggestions
| Line | Severity | Message | Rule |
|---|---|---|---|
| 36:53 | warning | 'Priya' is a possible misspelling. | PostHogBase.Spelling |
| 37:85 | warning | 'uncontacted' is a possible misspelling. | PostHogBase.Spelling |
contents/learn/data-stack/pocket-guide/onboarding-conversion/index.mdx — 0 errors, 1 warnings, 0 suggestions
| Line | Severity | Message | Rule |
|---|---|---|---|
| 55:76 | warning | Capitalize 'Product Analytics' for PostHog's product. Use 'Product analytics' for the general industry concept. | PostHogBase.ProductNames |
contents/learn/data-stack/pocket-guide/revenue-metrics/index.mdx — 0 errors, 1 warnings, 0 suggestions
| Line | Severity | Message | Rule |
|---|---|---|---|
| 33:3 | warning | Use American English. Use 'behavior' instead of 'behaviour'. | PostHogBase.AmericanEnglish |
contents/learn/data-stack/pocket-guide/upsell-ready-accounts/index.mdx — 0 errors, 4 warnings, 0 suggestions
| Line | Severity | Message | Rule |
|---|---|---|---|
| 2:36 | warning | 'upsell' is a possible misspelling. | PostHogBase.Spelling |
| 19:3 | warning | 'Northwind' is a possible misspelling. | PostHogBase.Spelling |
| 20:3 | warning | 'Globex' is a possible misspelling. | PostHogBase.Spelling |
| 37:83 | warning | 'Globex' is a possible misspelling. | PostHogBase.Spelling |
contents/learn/data-stack/pocket-guide/value-vs-engagement/index.mdx — 1 errors, 3 warnings, 0 suggestions
| Line | Severity | Message | Rule |
|---|---|---|---|
| 18:3 | warning | 'Globex' is a possible misspelling. | PostHogBase.Spelling |
| 19:3 | warning | 'Initech' is a possible misspelling. | PostHogBase.Spelling |
| 31:16 | error | Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. | PostHogBase.EnDash |
| 36:53 | warning | 'Globex' is a possible misspelling. | PostHogBase.Spelling |
contents/learn/data-stack/pocket-guide/warehouse-foundations/index.mdx — 0 errors, 2 warnings, 0 suggestions
| Line | Severity | Message | Rule |
|---|---|---|---|
| 35:86 | warning | 'unaliased' is a possible misspelling. | PostHogBase.Spelling |
| 45:27 | warning | Use the Oxford comma before 'and' or 'or' in a list of three or more items. | PostHogBase.OxfordComma |
src/components/PocketGuides/README.md — 0 errors, 5 warnings, 0 suggestions
| Line | Severity | Message | Rule |
|---|---|---|---|
| 94:3 | warning | 'Uncited' is a possible misspelling. | PostHogBase.Spelling |
| 149:5 | warning | 'Product Analytics Learn hub' heading should be in sentence case, and product names should be capitalized. | PostHogBase.SentenceCase |
| 152:362 | warning | 'scrollable' is a possible misspelling. | PostHogBase.Spelling |
| 154:290 | warning | Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept. | PostHogBase.ProductNames |
| 192:23 | warning | 'unmounts' is a possible misspelling. | PostHogBase.Spelling |
Add an opt-in `wrap` flag to TreeMenu items. Only Learn sidebars with learnNavFullTitles set it, so other sidebars keep one-line labels. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Summary
This PR adds a Learn tab to the Warehouse product page, like the Learn tab for AI Observability. The tab is at
/learn/warehouse. It shows the nine "Ask a quick question" chapters of the Data Stack pocket guide, such as "Which features drive revenue?", and it opens on the first chapter. The sidebar labels are the chapter questions, not the short names.To do this, the Data Stack guide moves from the Warehouse docs (
/docs/data-warehouse/pocket-guide) to/learn/warehouse/pocket-guide, which is the same layout as the other products with a Learn tab. The old URLs redirect permanently. The Warehouse docs sidebar now has one "Pocket guide" link to the Learn tab, as AI Observability's docs sidebar does.The six "Data modeling" chapters are not in the Learn tab sidebar. They are still pages of the guide: the guide's front page (
/learn/warehouse/pocket-guide, which/pocket-guides/data-stackopens) lists all 15 chapters.This PR is stacked on #21397. Merge #21397 first.
PR tour
src/constants/pocketGuides.ts: thedata-stackvolume getsproductHandle: 'data_warehouse'andlearnPath: '/learn/warehouse/pocket-guide'.src/hooks/productData/data_warehouse.tsx: setspocketGuideVolume: 'data-stack', the newpocketGuideSection: 'Ask a quick question', and the newlearnNavFullTitles: true.src/pages/learn/warehouse/index.tsx(new): the Learn tab root. It rendersLearnPagewith no chapter, so it opens on the section's first chapter.src/components/PocketGuides/bookModel.tsx: addssectionPages(pages, section).src/components/PocketGuides/LearnSurface.tsxandLearnPage.tsx: with a section, the Learn root opens the section's first page. A chapter in the section moves only between the section's chapters. Other pages, such as the front page, keep the whole book.src/components/Products/ReaderViewProduct/buildProductMenuTabs.tsx:LearnNavlists only the section's pages, uses full titles whenlearnNavFullTitlesis set, and marks the first chapter as active on the Learn root.vercel.json: redirects/docs/data-warehouse/pocket-guide,.md, and/:path*to the new URLs. The/pocket-guides/data-stackand/pocket-guides/context-warehouseredirects go to the new URLs in one hop.src/navs/index.js: the 15-chapter "Pocket guide" tree in the Warehouse docs becomes one link to/learn/warehouse.contents/learn/data-stack/,src/pages/context-warehouse/use-cases.tsx, and the README use the new URLs. Gatsby links do not followvercel.jsonredirects.src/components/TreeMenu/index.tsx: adds an optionalwrapflag to sidebar items. A label withwrapgoes onto more lines, and it does not truncate or scroll on hover. Only the Warehouse Learn items set it, so other sidebars do not change.learnRoutes.test.tsno longer lists Data Stack as a docs-only book, and it has a new test for the redirects.pocketGuides.test.tschecks that a Learn tab'slearnPathstarts with/learn/<product slug>. Before, it used the docs slug, which is not the same for Warehouse (/docs/data-warehouse,/warehouse).🔍 Reviewer's guide
What to look at
src/constants/pocketGuides.ts,src/navs/index.js,learnRoutes.test.ts). Master made Data Stack a docs-only book. This PR reverses that, so that Warehouse has a Learn tab like the other products. Please confirm this with #team-website. If it is wrong, the guide stays at the new URL, and the old URLs only redirect.LearnSurface.tsx,LearnPage.tsx,buildProductMenuTabs.tsx,TreeMenu/index.tsx). Product Analytics, AI Observability, Session Replay, and Feature Flags use them. If a product does not setpocketGuideSectionorlearnNavFullTitles, nothing changes for it.TreeMenuis used by most sidebars on the site. The newwrapflag is off unless an item sets it.Checks
prettieron the changed filesnode --test src/components/PocketGuides/*.test.ts: 43 passtsc --noEmit: no new errors in the changed files. The errors inLearnPage.tsx,LearnSurface.tsx,buildProductMenuTabs.tsx, anduse-cases.tsxare also on the base branch./learn/warehouse,/learn/warehouse/pocket-guide, a chapter, and/learn/ai-observability. All show the same error types (React Burger menu color fix #418/Small fixes for pricing and free trial pages #423 hydration, SVGwidth="auto"). The Warehouse pages also have a 404 for the.mdcopy of the page, which occurs on all previews./docs/data-warehouse/pocket-guideand/pocket-guides/data-stack: not tested end to end. The Cloudflare preview does not applyvercel.jsonredirects.learnRoutes.test.tschecks the entries.Screenshots
Before is the deploy preview for #21397 (f13fc17). After is the deploy preview for this PR (9cb7fcc). Narrow is 640px, wide is 1440px. At 640px the sidebar is collapsed, so the narrow images do not show the sidebar.
/warehousesidebar (new Learn tab)/learn/warehouse(new page, no before)Warehouse docs sidebar (
/docs/data-warehouse): the chapter tree becomes one "Pocket guide" link🤖 Generated with Claude Code