Skip to content

feat(warehouse): add a Learn tab with the data stack quick questions - #21399

Merged
Lizzieepton merged 14 commits into
masterfrom
lizzie/warehouse-learn-tab
Oct 26, 2026
Merged

Lizzieepton merged 14 commits into
masterfrom
lizzie/warehouse-learn-tab

Conversation

@Lizzieepton

@Lizzieepton Lizzieepton commented Oct 20, 2026 •

Copy link
Copy Markdown
Contributor

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-stack opens) lists all 15 chapters.

This PR is stacked on #21397. Merge #21397 first.

PR tour

  1. src/constants/pocketGuides.ts: the data-stack volume gets productHandle: 'data_warehouse' and learnPath: '/learn/warehouse/pocket-guide'.
  2. src/hooks/productData/data_warehouse.tsx: sets pocketGuideVolume: 'data-stack', the new pocketGuideSection: 'Ask a quick question', and the new learnNavFullTitles: true.
  3. src/pages/learn/warehouse/index.tsx (new): the Learn tab root. It renders LearnPage with no chapter, so it opens on the section's first chapter.
  4. src/components/PocketGuides/bookModel.tsx: adds sectionPages(pages, section).
  5. src/components/PocketGuides/LearnSurface.tsx and LearnPage.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.
  6. src/components/Products/ReaderViewProduct/buildProductMenuTabs.tsx: LearnNav lists only the section's pages, uses full titles when learnNavFullTitles is set, and marks the first chapter as active on the Learn root.
  7. vercel.json: redirects /docs/data-warehouse/pocket-guide, .md, and /:path* to the new URLs. The /pocket-guides/data-stack and /pocket-guides/context-warehouse redirects go to the new URLs in one hop.
  8. src/navs/index.js: the 15-chapter "Pocket guide" tree in the Warehouse docs becomes one link to /learn/warehouse.
  9. Links: chapter "See also" links in contents/learn/data-stack/, src/pages/context-warehouse/use-cases.tsx, and the README use the new URLs. Gatsby links do not follow vercel.json redirects.
  10. src/components/TreeMenu/index.tsx: adds an optional wrap flag to sidebar items. A label with wrap goes 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.
  11. Tests: learnRoutes.test.ts no longer lists Data Stack as a docs-only book, and it has a new test for the redirects. pocketGuides.test.ts checks that a Learn tab's learnPath starts 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

  1. The Data Stack guide leaves the docs (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.
  2. Shared components (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 set pocketGuideSection or learnNavFullTitles, nothing changes for it. TreeMenu is used by most sidebars on the site. The new wrap flag is off unless an item sets it.
  3. Data modeling chapters are not in the Learn sidebar. A reader gets to them from the guide's front page or a chapter's "See also" links.

Checks

  • prettier on the changed files
  • node --test src/components/PocketGuides/*.test.ts: 43 pass
  • tsc --noEmit: no new errors in the changed files. The errors in LearnPage.tsx, LearnSurface.tsx, buildProductMenuTabs.tsx, and use-cases.tsx are also on the base branch.
  • Screenshots: see below
  • Console: puppeteer on the preview (bf4b54a) for /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, SVG width="auto"). The Warehouse pages also have a 404 for the .md copy of the page, which occurs on all previews.
  • Redirects from /docs/data-warehouse/pocket-guide and /pocket-guides/data-stack: not tested end to end. The Cloudflare preview does not apply vercel.json redirects. learnRoutes.test.ts checks 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.

/warehouse sidebar (new Learn tab)

State Before After
Light, narrow window
Light, wide window
Dark, narrow window
Dark, wide window

/learn/warehouse (new page, no before)

State After
Light, narrow window
Light, wide window
Dark, narrow window
Dark, wide window

Warehouse docs sidebar (/docs/data-warehouse): the chapter tree becomes one "Pocket guide" link

State Before After
Light, narrow window
Light, wide window
Dark, narrow window
Dark, wide window

🤖 Generated with Claude Code

claude and others added 3 commits October 19, 2026 20:39
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>
@github-actions

github-actions Bot commented Oct 20, 2026 •

Copy link
Copy Markdown
Contributor

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Oct 26, 2026 04:11PM

@github-actions

github-actions Bot commented Oct 20, 2026 •

Copy link
Copy Markdown
Contributor

Bundle report

Total JS (gzip)

10.43 MiB (+30.8 KiB / +0.3%)

Largest changed named chunks
Chunk Gzip Δ vs master
655c369601e38a7136cffdc999798d51fd71fc19.js 49.8 KiB new
app.js 2345.0 KiB -41.2 KiB / -1.7%
component---src-pages-desktop-tsx.js 25.3 KiB new
47d90eddd1e286b0d0e7b096ab3157885ca00a1d.js 10.5 KiB new
78f6350c99e28d0c1d72c92320a2a22aa65b541a.js 5.6 KiB new
component---src-pages-changelog-video-index-tsx.js 3.3 KiB +2.9 KiB / +777.6%
component---src-pages-spicy-mov-index-tsx.js 3.3 KiB +2.9 KiB / +783.8%
component---src-pages-demo-index-tsx.js 3.3 KiB +2.9 KiB / +707.5%
component---src-pages-videos-play-tsx.js 3.7 KiB +2.8 KiB / +313.8%
component---src-pages-services-tsx.js 9.4 KiB +2.3 KiB / +33.2%
component---src-pages-events-tsx.js 1.5 KiB new
component---src-pages-events-strapi-id-tsx.js 1.8 KiB +1.4 KiB / +361.8%
component---src-pages-sparks-joy-dictator-or-tech-bro-index-tsx.js 3.3 KiB +1.0 KiB / +47.3%
component---src-pages-sparks-joy-hogpatch-index-tsx.js 3.3 KiB +1.0 KiB / +46.6%
component---src-pages-sparks-joy-brickhog-index-tsx.js 3.2 KiB +1.0 KiB / +47.3%

Eager graph (modules shipped in each entrypoint's initial chunks)

Entrypoint Eager size Budget Modules
✅ app 20.20 MiB (-694.5 KiB / -3.2%) report-only 2106
Largest modules in the app closure
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).

@Lizzieepton
Lizzieepton marked this pull request as ready for review October 20, 2026 11:22
@Lizzieepton
Lizzieepton requested a review from a team as a code owner October 20, 2026 11:22
@github-actions

github-actions Bot commented Oct 20, 2026 •

Copy link
Copy Markdown
Contributor

AEO/SEO: I'm in danger

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)

  • 6 redirects removed in vercel.json
    Old URLs that people, search engines, or AI agents still visit will start to return 404: /pocket-guides/data-stack, /pocket-guides/data-stack.md, /pocket-guides/data-stack/:path*, /pocket-guides/context-warehouse, /pocket-guides/context-warehouse.md, and more.
    Fix: Keep a redirect for any URL that still gets traffic or has backlinks.

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.

EDsCODE and others added 7 commits October 20, 2026 16:07
…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
@Lizzieepton
Lizzieepton force-pushed the lizzie/warehouse-learn-tab branch from 3662f43 to 4a248b1 Compare October 23, 2026 09:49
@github-actions github-actions Bot added the website About the website (beyond just landing pages) label Oct 23, 2026
@Lizzieepton Lizzieepton changed the title feat(warehouse): add a Learn tab with the data stack quick questions feat(warehouse): label the data stack quick questions with their full questions Oct 23, 2026
- 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>
@Lizzieepton
Lizzieepton force-pushed the lizzie/warehouse-learn-tab branch from 4a248b1 to bf4b54a Compare October 23, 2026 13:04
@github-actions github-actions Bot removed the website About the website (beyond just landing pages) label Oct 23, 2026
@Lizzieepton Lizzieepton changed the title feat(warehouse): label the data stack quick questions with their full questions feat(warehouse): add a Learn tab with the data stack quick questions Oct 23, 2026
@github-actions

github-actions Bot commented Oct 23, 2026 •

Copy link
Copy Markdown
Contributor

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!

contents/learn/data-stack/pocket-guide/acquisition-channels-retention/index.mdx — 0 errors, 1 warnings, 0 suggestions
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

@sarahxsanders sarahxsanders left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

LEARN!!!!!

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>
Base automatically changed from lizzie/warehouse-product-page to master October 26, 2026 15:36
@Lizzieepton
Lizzieepton requested a review from a team October 26, 2026 15:36
@Lizzieepton
Lizzieepton enabled auto-merge (squash) October 26, 2026 15:44
@Lizzieepton
Lizzieepton merged commit 878c3d6 into master Oct 26, 2026
22 checks passed
@Lizzieepton
Lizzieepton deleted the lizzie/warehouse-learn-tab branch October 26, 2026 16:12
@github-project-automation github-project-automation Bot moved this from Backlog to Done in PostHog.com planning Oct 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

5 participants