Skip to content

Add data stack positioning handbook page - #21624

Merged
Lizzieepton merged 7 commits into
masterfrom
handbook/data-stack-positioning
Oct 28, 2026
Merged

Lizzieepton merged 7 commits into
masterfrom
handbook/data-stack-positioning

Conversation

@Lizzieepton

@Lizzieepton Lizzieepton commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor

Changes

This PR adds a new handbook page: Data stack positioning. The page is in the sidebar at Sales > Enablement and resources > Data Stack enablement, below Data foundations.

The page gives the sales team the content from the data stack positioning deck. It tells sales what to sell, to which persona, and when. It has these sections:

  • How PostHog covers steps 2 to 7 of the data stack, and the three messaging pillars.
  • The two packages. The regular package is for product engineers. The sexy package is for data leads.
  • For each package: why we sell it, the signals that a user is ready to buy, what is included, and what to say.
  • The competitors at each layer of the stack, and how to position PostHog against them.
  • A comparison of dbt concepts to PostHog concepts.

The page does not repeat the persona details. It links to the Data foundations page for them.

Nav screenshots (before/after) are in a comment below.

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 (no pages moved)

Notes:

  • The local dev server did not start. The build failed on errors that are not related to this PR: missing onboarding/ai-observability/_snippets/*.tsx imports in contents/docs/ai-observability/_snippets. I checked the page in the preview build. The page and the nav entry show correctly. The console shows React Burger menu color fix #418 hydration errors, but the live site shows the same errors, so this PR does not cause them.
  • The pre-commit hooks (prettier, eslint, markdownlint) ran on the changed files.

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Oct 28, 2026 11:46AM

Changed pages

Page Source
Data stack positioning contents/handbook/growth/sales/data-stack-positioning.md

@github-actions

github-actions Bot commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor

Vale prose linter → found 1 errors, 20 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/growth/sales/data-stack-positioning.md — 1 errors, 20 warnings, 0 suggestions
Line Severity Message Rule
18:18 warning Capitalize 'Data Pipelines' for PostHog's product. Use 'Data pipelines' for the general industry concept. PostHogBase.ProductNames
23:19 warning Capitalize 'Data Pipelines' for PostHog's product. Use 'Data pipelines' for the general industry concept. PostHogBase.ProductNames
25:209 warning Use 'FiveTran' instead of 'Fivetran'. Vale.Terms
25:255 warning 'Hightouch' is a possible misspelling. PostHogBase.Spelling
47:49 warning Capitalize 'Product Analytics' for PostHog's product. Use 'product analytics' for the general industry concept. PostHogBase.ProductNames
49:46 warning Capitalize 'Data Pipelines' for PostHog's product. Use 'data pipelines' for the general industry concept. PostHogBase.ProductNames
84:90 warning Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. PostHogBase.ProductNames
118:3 warning Capitalize 'Data Pipelines' for PostHog's product. Use 'Data pipelines' for the general industry concept. PostHogBase.ProductNames
118:100 warning Use 'FiveTran' instead of 'Fivetran'. Vale.Terms
118:112 warning 'Airbyte' is a possible misspelling. PostHogBase.Spelling
119:3 warning Capitalize 'Data Warehouse' for PostHog's product. Use 'Data warehouse' for the general industry concept. PostHogBase.ProductNames
125:5 warning 'Key message: analyze, don't babysit pipelines' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
135:95 warning Use the Oxford comma before 'and' or 'or' in a list of three or more items. PostHogBase.OxfordComma
144:15 warning Use 'FiveTran' instead of 'Fivetran'. Vale.Terms
144:25 warning 'Airbyte' is a possible misspelling. PostHogBase.Spelling
146:19 warning 'SQLMesh' is a possible misspelling. PostHogBase.Spelling
147:28 warning 'Dagster' is a possible misspelling. PostHogBase.Spelling
147:79 warning 'materializations' is a possible misspelling. PostHogBase.Spelling
149:16 warning 'Hightouch' is a possible misspelling. PostHogBase.Spelling
153:132 warning Use the Oxford comma before 'and' or 'or' in a list of three or more items. PostHogBase.OxfordComma
164:34 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

@posthog posthog Bot 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.

PostHog Review · Standard · reviewed 41d3749: 1 Should fix.

See this review and its findings in PostHog Review. Comment @posthog review --deep for a Deep review. A Deep review takes longer and looks deeper than a Standard review.

| `ref()` and the DAG | Dependency-ordered refresh + lineage |
| dbt Cloud jobs / Airflow | Built-in schedule, 15 minutes to monthly |
| Semantic layer (MetricFlow) | Semantic layer |
| Tests and Git workflow | Not yet – Git is on the roadmap |

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.

P2 · Separate available data quality tests from missing Git support

When sales uses this comparison for customers evaluating dbt, Not yet incorrectly says PostHog lacks tests. The existing /docs/data-warehouse/data-quality documentation describes not-null, uniqueness, relationship, and custom SQL checks, including checks that block materialization. This misstates a relevant capability; list data quality checks separately from the missing Git workflow.

@github-actions

github-actions Bot commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor

Bundle report

Total JS (gzip)

10.44 MiB (+1.3 KiB / +0.0%)

Largest changed named chunks
Chunk Gzip Δ vs master
app.js 2350.6 KiB +1.3 KiB / +0.1%

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

Entrypoint Eager size Budget Modules
✅ app 20.34 MiB (+7.1 KiB / +0.0%) report-only 2111
Largest modules in the app closure
Module Size
./src/data/mcp-tools.json 1437.6 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 817.2 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 + 61 modules 381.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 314.2 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

Copy link
Copy Markdown
Contributor Author

Nav screenshots

Before After
Nav before Nav after

The new page is below Data foundations in Data Stack enablement. The after screenshot is from the preview build.

@posthog posthog Bot 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.

PostHog Review · Standard · reviewed e3031d7: 1 Should fix.

github-actions Bot and others added 2 commits October 28, 2026 10:42
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Lizzieepton and others added 2 commits October 28, 2026 11:26
Co-authored-by: Joe Martin <84011561+joethreepwood@users.noreply.github.com>
@Lizzieepton
Lizzieepton enabled auto-merge (squash) October 28, 2026 11:26
@Lizzieepton Lizzieepton self-assigned this Oct 28, 2026
@Lizzieepton
Lizzieepton merged commit d396f4b into master Oct 28, 2026
22 checks passed
@Lizzieepton
Lizzieepton deleted the handbook/data-stack-positioning branch October 28, 2026 11:50
@github-project-automation github-project-automation Bot moved this from Backlog to Done in PostHog.com planning Oct 28, 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.

2 participants