Skip to content

fix(docs): make /docs/billing a real page to stop 404s - #19736

Closed
posthog[bot] wants to merge 1 commit into
masterfrom
posthog-self-driving/fix-broken-internal-links-causing-404s-52bb53
Closed

posthog[bot] wants to merge 1 commit into
masterfrom
posthog-self-driving/fix-broken-internal-links-causing-404s-52bb53

Conversation

@posthog

@posthog posthog Bot commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

Changes

Problem

  • Users clicking a doc link or search result for /docs/billing hit the 404 screen, and the page_404 event fires.
  • The contents/docs/billing/ folder held only child pages, so Gatsby built no page at /docs/billing.
  • The vercel.json redirect for /docs/billing only runs at the edge on hard loads. In-app clicks navigate client-side, where the redirect never applies, so the user reaches a missing route.

Fix

  • Add contents/docs/billing/index.md, a billing overview that links the five existing child pages. This gives /docs/billing a real page, so client-side navigation, direct links, and search all resolve.
  • Remove the now-contradictory /docs/billing edge redirect so the page serves the same way on hard loads and gets indexed for search.

Scope note

  • The source report also flagged a site-wide React Burger menu color fix #418 hydration mismatch. That is a separate defect from the observed 404 and needs its own investigation, so it is out of scope here.

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

Created with PostHog Desktop from this inbox report.

The billing folder held only child pages, so /docs/billing was not a Gatsby
page. Inline doc links and search results that point there navigate
client-side, where the vercel.json edge redirect does not apply, so the user
lands on the 404 screen.

Add contents/docs/billing/index.md as a billing overview that links the five
child pages, and remove the now-contradictory /docs/billing edge redirect so
the page serves consistently on hard loads and gets indexed for search.

Generated-By: PostHog Desktop
Task-Id: 69b6b823-b20b-4a77-9910-71ce221c590c
@posthog

posthog Bot commented Aug 26, 2026 •

Copy link
Copy Markdown
Contributor Author

🦔 ReviewHog reviewed this pull request

Nothing worth raising this time, so here's a calming picture instead:

Someone relaxing in a sunny garden

@github-actions

github-actions Bot commented Aug 26, 2026 •

Copy link
Copy Markdown
Contributor

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Aug 26, 2026 11:30AM

@github-actions

Copy link
Copy Markdown
Contributor

Bundle report

Total JS (gzip)

8.16 MiB (+0.2 KiB / +0.0%)

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

Entrypoint Eager size Budget Modules
✅ app 16.88 MiB (+2.1 KiB / +0.0%) report-only 2034
Largest modules in the app closure
Module Size
./src/data/mcp-tools.json 1041.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 759.3 KiB
./src/components/Stickers/Stickers.tsx 696.4 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/rehype-raw@7.0.0/node_modules/rehype-raw/lib/index.js + 29 modules 395.1 KiB
./src/hooks/useCustomers.tsx + 55 modules 369.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
./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 + 126 modules 301.7 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/SearchUI/index.tsx + 87 modules 273.0 KiB
./node_modules/.pnpm/@posthog+brand@0.8.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/magnifying-glass.mjs 254.7 KiB
./node_modules/.pnpm/framer-motion@10.18.0_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/framer-motion/dist/es/render/dom/motion.mjs + 109 modules 253.9 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 240.1 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).

@posthog
posthog Bot marked this pull request as ready for review August 26, 2026 11:32
@github-actions

Copy link
Copy Markdown
Contributor

This PR hasn't seen activity in two weeks! Should it be merged, closed, or further worked on? If you want to keep it open, please remove the stale label – otherwise this will be closed in another week. If you want to permanently keep it open, use the waiting label.

@github-actions github-actions Bot added the stale This pull request has been marked as stale and will be closed soon automatically label Sep 10, 2026
@ianmatson

Copy link
Copy Markdown
Contributor

Replaced by #20111.

The repo has two links to /docs/billing: one in the downsampling guide and one in the MCP FAQ. The replacement PR points both links to /docs/billing/estimating-usage-costs and keeps the existing Vercel redirect for direct visits. A new billing overview page is not needed.

The replacement PR is a draft until page and console checks pass. Closing this PR in favor of that smaller fix.

@ianmatson ianmatson closed this Sep 11, 2026
@github-project-automation github-project-automation Bot moved this from Backlog to Done in PostHog.com planning Sep 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

stale This pull request has been marked as stale and will be closed soon automatically

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

1 participant