docs(cdp): Add BugHerd source documentation

[inkeep]

Changes

This PR adds user-facing documentation for the new BugHerd data warehouse source that was implemented in PostHog/posthog#73208.

New page

• contents/docs/cdp/sources/bugherd.md - Documentation for linking BugHerd as a data warehouse source

What's documented

• Setup instructions: How to find the API key in BugHerd Settings > General Settings (requires owner/admin access)
• Available tables: Organization, Users, Projects, and Tasks
• Sync methods: Tasks supports incremental sync via updated_at; all other tables are full refresh
• Sync limitations: Explains that only Tasks has a reliable server-side timestamp filter

Related PR

• feat(data-warehouse): add BugHerd source posthog#73208 - feat(data-warehouse): add BugHerd source

---

This PR was created by the Inkeep Content Writer agent, which is maintained by the Docs and Wizard team. Please reach out on Slack for help if needed.

[github-actions]

Deploy preview

Status	Details	Updated (UTC)
🟢 Ready	View preview	Jul 24, 2026 01:04PM

[github-actions]

Vale prose linter → found 0 errors, 2 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/docs/cdp/sources/bugherd.md — 0 errors, 2 warnings, 0 suggestions

Line	Severity	Message	Rule
18:129	warning	Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept.	PostHogBase.ProductNames
43:162	warning	Capitalize 'Endpoints' for PostHog's product. Use 'endpoints' for the general industry concept.	PostHogBase.ProductNames

[github-actions]

Bundle report

Total JS (gzip)

6.74 MiB (no change)

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

Entrypoint	Eager size	Budget	Modules
✅ app	16.19 MiB (no change)	report-only	1985

Largest modules in the app closure

Module	Size
./src/data/mcp-tools.json	918.7 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	741.7 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
./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
./src/hooks/useCustomers.tsx + 54 modules	355.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.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
./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 + 120 modules	278.8 KiB
./src/components/SearchUI/index.tsx + 87 modules	272.1 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	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 for the modules actually shipped in the entrypoint's initial chunks (post-tree-shake).

[github-actions]

Hey @Gilbert09! This docs PR was generated for you by an agent. You're responsible for reviewing and merging it into production.

1. Review and approve the PR
2. Merge the PR
   a. Check the preview env and CI build and merge it yourself
   b. Enable auto-merge if you're confident in the changes