Skip to content

docs(batch-exports): document backfill estimation and progress tracking#15326

Merged
rossgray merged 2 commits intomasterfrom
docs-writer-ai-update-2026-02-26T10-32-54-503Z-u47lwa
Feb 27, 2026
Merged

docs(batch-exports): document backfill estimation and progress tracking#15326
rossgray merged 2 commits intomasterfrom
docs-writer-ai-update-2026-02-26T10-32-54-503Z-u47lwa

Conversation

@inkeep
Copy link
Contributor

@inkeep inkeep bot commented Feb 26, 2026

Changes

This PR updates the batch exports documentation to reflect new backfill features introduced in PostHog/posthog#47788.

Updates to contents/docs/cdp/batch-exports/index.mdx:

Backfills section:

  • Documented the new Starting status that appears while PostHog estimates total records and validates the date range
  • Explained the status transition from StartingRunning once estimation is complete
  • Added documentation for the new total_records_count field showing estimated records to be exported
  • Added documentation for the adjusted_start_at field showing if PostHog narrowed the backfill date range
  • Documented that backfills with no matching data complete immediately with 0 records

Why

PR #47788 introduced several user-facing changes to batch export backfills:

  1. Backfills now use a STARTING status during the estimation phase before transitioning to RUNNING
  2. Users can now see an estimated total record count for their backfill
  3. Users can see if/when PostHog adjusted their backfill start date based on available data
  4. Backfills with no data complete early instead of creating unnecessary batch runs

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.

…tal records count, and early completion

Reflects changes from PostHog/posthog#47788:
- Document new STARTING status during estimation phase
- Add total_records_count and adjusted_start_at fields
- Document early completion when no matching data exists
- Update phrasing since backfills no longer immediately schedule runs
@inkeep inkeep bot requested a review from rossgray February 26, 2026 10:34
@vercel
Copy link

vercel bot commented Feb 26, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
posthog Ready Ready Preview Feb 26, 2026 3:44pm

Request Review

@github-actions
Copy link
Contributor

github-actions bot commented Feb 26, 2026

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Feb 26, 2026 03:41PM

@github-actions
Copy link
Contributor

github-actions bot commented Feb 26, 2026

Vale prose linter → found 0 errors, 12 warnings, 1 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/batch-exports/index.mdx — 0 errors, 12 warnings, 1 suggestions
Line Severity Message Rule
77:116 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
77:182 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
120:30 warning Use American English. Use 'canceling' instead of 'cancelling'. PostHogBase.AmericanEnglish
126:76 warning Use bold (text) for UI elements, not quotes. PostHogDocs.UIBoldNotQuotes
128:27 warning Use 'UI' instead of 'ui'. Vale.Terms
141:4 warning 'FAQ' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
145:201 warning Capitalize 'Workflows' for PostHog's product. Use 'workflows' for the general industry concept. PostHogBase.ProductNames
145:219 warning Capitalize 'Workflows' for PostHog's product. Use 'workflows' for the general industry concept. PostHogBase.ProductNames
147:43 warning Capitalize 'Workflows' for PostHog's product. Use 'workflows' for the general industry concept. PostHogBase.ProductNames
147:144 warning Capitalize 'Workflows' for PostHog's product. Use 'workflows' for the general industry concept. PostHogBase.ProductNames
149:18 warning Capitalize 'Workflows' for PostHog's product. Use 'workflows' for the general industry concept. PostHogBase.ProductNames
151:485 warning Capitalize 'Workflows' for PostHog's product. Use 'workflows' for the general industry concept. PostHogBase.ProductNames
195:37 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames

@rossgray rossgray merged commit a7358df into master Feb 27, 2026
18 checks passed
@rossgray rossgray deleted the docs-writer-ai-update-2026-02-26T10-32-54-503Z-u47lwa branch February 27, 2026 18:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant