github.com-cloudflare-cloudflare-docs
all · 139 devs · built 2026-06-13
Repository snapshot
Monthly reports
Highlights
- Introduction of a *new automated style guide review bot* using the `flue` agent framework, enhancing documentation quality via [52de1c50 · vance].
- Release of *Cloudflare One client Q2-1 beta* with new UI, VNET availability, and DNS search suffixes, accompanied by updated documentation in [1c7c4cc4 · Yi Huang].
- Comprehensive refactoring and polishing of the *Billing documentation suite* to improve clarity and user experience, as seen in [09c13be1 · Dmitry Alexeenko].
- Extensive updates across various product documentations, including *Durable Objects* error handling ([43f3eaa7 · Andrew Williams], [be46a18f · Brandon Iglesias]), *Logpush* field definitions ([ce6ba215 · Sohei Okamoto]), and *R2 Data Catalog* dashboard integration ([34a56d4b · Marc Selwan]).
- Enhanced guidance for *Browser Run Quick Actions* with *Workers bindings* through new examples and explanations in [c133a7c2 · Kathy] and [0ea22dc5 · Maryna Iholnykova].
- Documentation of *Cloudflare Tunnel's* new `cloudflared` connectivity pre-checks, simplifying setup and troubleshooting via [285f062b · Nikita Cano].
Observations
- Overall development output decreased by 59% (23 current vs 55 2-month average) compared to the 2-month average, indicating a notable slowdown in activity during May 2026.
- The *grow score* experienced a 55% reduction (3 current vs 7 2-month average) and *maintenance score* dropped by 59% (19 current vs 47 2-month average) compared to the 2-month average.
- Commit volume was 373 this period, a 41% decrease from the 2-month average of 631 commits.
- A significant positive trend is the *waste score* dropping to 0 in May 2026, representing a 99% decrease from the 2-month average of 1, suggesting highly focused and effective contributions with minimal rework.
- A recurring pattern involved updates to `.github/CODEOWNERS` files, with 5 commits ([27bec3b8 · Thomas Gauvin], [974b0e9d · Dave Baxter], [e9d5dbc0 · Vy Ton], [91a3719f · Jolin Zhou], [269b157f · alpdot], [f0558c99 · Jeff Hochberg]) assigning new code owners for various product documentation areas like *agents*, *sandbox*, *Security Center*, *WARP*, and *network services*.
- Several commits focused on clarifying error codes and operational limits, such as *Durable Objects* `RangeError` ([43f3eaa7 · Andrew Williams]), *Email Service* `E_TOO_MANY_ATTACHMENTS` ([b5217e64 · Luís Duarte]), and *AI Gateway* Unified Billing rate limits ([2e8e23b3 · Ming Lu]).
- A consistent theme was the documentation of new product features and enhancements, including *Realtime SFU WebSocket adapter* auto-reconnects ([ff68379b · korinne]), *Cloudflare One* AI-powered regex assistance ([9522de11 · aj]), and *Pages* Hugo build caching ([9ca40cb2 · Eric Clemmons]).
Performance over time
ETV stacked by Growth, Maintenance and Fixes — 90-day moving average, normalized to ETV / month.
Average performance per developer
ETV per active developer per month — 30-day moving average.
Active developers over time
Unique developers committing each day — 90-day moving average.
Knowledge concentration
How dependent is this repo on a small number of contributors? Higher top-1 share = higher key-person risk.
Pedro Sousa owns 6.5 % of commits.
Top contributors
Most impactful commits
Top 20 by ETV in the all-time window.
- 5.6ETVfeat: Add AI agent setup directory (#30115) * first pass * ui improvements * Add agent-setup homepage section with illustration * Replace agents illustration with combined SVG, adjust sizing * agent-setup page overhaul * agent specific pages improvements * fix: add primary_type field to AgentData type and schema * chore: fix prettier formatting in agent-setup.css * claude code improvements * first pass using mdx for agent files * finalize switch to mdx * fix troubleshooting UI * mobile ui * format * codex changes * first content accuracy pass * compare agents table improvements * increase space between sections on agent-setup page * fix * address bonk * feedback * formatting * feat: swap homepage section order — agent setup before Build with Cloudflare * Add agent-setup directory entry for llms.txt and Algolia indexingvance · b5858c4a · 2026-04-23
- 2.3ETVPages banner (#22134) * Add sparkles to migration guide and support dismissible banner * Add banner to PagesGreg Brimble · d16cfc4a · 2025-05-09
- 1.8ETVAdded products and description to frontmatter (#30235)Denise Peña · eafa62a7 · 2026-04-23
- 1.8ETV[Dev Plat] Added product & description to frontmatter (#30101) * Added product & description to frontmatter * Apply suggestions from code review Co-authored-by: Caley Burton <caley@cloudflare.com> * Update src/content/docs/ai/related-products/sandbox-sdk.mdx Co-authored-by: devin-ai-integration[bot] <158243242+devin-ai-integration[bot]@users.noreply.github.com> --------- Co-authored-by: Caley Burton <caley@cloudflare.com> Co-authored-by: devin-ai-integration[bot] <158243242+devin-ai-integration[bot]@users.noreply.github.com>Denise Peña · 3032c99b · 2026-04-20
- 1.8ETVAi descriptions util (#25736) * Edits * final files * remove tab * fix more tabs * fixed steps * fix * final fix * Update src/content/docs/cloudflare-one/tutorials/okta-u2f.mdx Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com> * Update src/content/docs/cloudflare-one/tutorials/vnc-client-in-browser.mdx Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com> * Update src/content/docs/r2/tutorials/cloudflare-access.mdx Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com> * Update src/content/docs/pages/how-to/deploy-a-wordpress-site.mdx Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com> * Update src/content/docs/pages/migrations/migrating-from-netlify.mdx Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com> * Update src/content/docs/reference-architecture/design-guides/network-vpn-migration.mdx Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com> * Update src/content/docs/ssl/keyless-ssl/hardware-security-modules/ibm-cloud-hsm.mdx Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com> * Update src/content/docs/turnstile/tutorials/excluding-turnstile-from-e2e-tests.mdx Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com> * update --------- Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com>Kody Jackson · cc1d81c8 · 2025-10-09
- 1.6ETV[Dev Plat] Added product & description to frontmatter (#30232) * Added product & description to frontmatter * Apply suggestions from code review Co-authored-by: Jun Lee <junlee@cloudflare.com> --------- Co-authored-by: Jun Lee <junlee@cloudflare.com>Denise Peña · 13ae31af · 2026-04-23
- 1.6ETV[Network Security] Added product & description to frontmatter (#30043) * Added product & description to frontmatter * Strip 1.1.1.1 to unblock * Formatting fix --------- Co-authored-by: kodster28 <kody@cloudflare.com>Denise Peña · 2cb61166 · 2026-04-17
- 1.6ETV[Docs Site] Rename changelog collection to release-notes (#19969) * [Docs Site] Rename changelog collection to release-notes * fix redirects * assert entry is inside a product folderKian · 114602a3 · 2025-02-13
- 1.4ETV[Use cases] Add new use cases documentation (#29162) --------- Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com> Co-authored-by: Cody Anthony <canthony@cloudflare.com>db-cloudflare · 0dc3582c · 2026-04-01
- 1.4ETVfeat: Add flue style guide review bot (#31072) * first pass * fix: pass reviewedFiles to reconciler so incremental reviews correctly resolve fixed findings * [flue] Add wrangler dev script and orchestrator improvements * [flue] Refactor style guide references, improve review quality and speed - Restructure style guide references into always/, conditional/, components/ subdirectories - Update manifest to use granular per-component reference files - Add stale file cleanup to sync-agents script - Improve style-guide-review SKILL.md: add patch parsing, no-enumeration, and no-absence-reasoning instructions - Preserve existing bot comment body when posting pending review update - Add clear-r2-pr-data.ts utility script - Minor orchestrator and spam filter improvements * [flue] Add commands section to code review comment * [flue] Remove import-only component refs, add commands section, fix pending comment body * [flue] Fix duplicate pending status when /full-review is triggered on existing pending comment * [flue] Add /review command for on-demand incremental or full review * [flue] Cap automatic reviews at 2 per PR, bypass for codeowner commands * [flue] Skip spam filter for codeowner-opened issues and PRs * [flue] Remove PR allowlist gating — ready for production * fix: Address PR review feedback — label bug, comment pagination, table cell escaping, wrangler-config example * chore: format flue agent files with prettier * [flue] Restrict code review to codeowner PRs; reduce log noise * fix: prefix unused reviewResponse vars with underscore to satisfy ESLint * [flue] Remove codeowner gate — auto-review all PRs * [flue] Fix duplicate paused message in review limit comment * [flue] Fix duplicate paused message — skip update if already paused * fix: address PR review feedback — section numbers, no-op replace, table sanitization, JSDoc * chore: bump @flue/cli and @flue/runtime to 0.7.1vance · 52de1c50 · 2026-05-29
- 1.4ETVAdded frontmatter to remaining app perf products (#30012)Denise Peña · ca88e236 · 2026-04-16
- 1.4ETV[wrangler] replace mentions of wrangler.json with wrangler.json(c) (#19764) * update references of wrangler.json to wrangler.json(c) * change to wrangler config file with link * Update src/content/partials/workers/secrets-in-dev.mdx --------- Co-authored-by: Jun Lee <junlee@cloudflare.com>emily-shen · 98fcddbe · 2025-02-12
- 1.3ETV[ZT] update CF1 dash path in Access docs (#30501) * update dash path in Access docs * Apply suggestions from code review Co-authored-by: ranbel <101146722+ranbel@users.noreply.github.com>ranbel · e767a5bd · 2026-04-30
- 1.3ETV[WAF] Add new nav instructions (#23529) --------- Co-authored-by: Jun Lee <junlee@cloudflare.com>Pedro Sousa · 01ec05dc · 2025-07-09
- 1.3ETV[DNS] Update proxy status page and improve information overload (#19728) * Recap what are DNS records, remove image, and add Benefits h3 * Briefly explain the example pointing to Fundamentals for more * Remove repeated explanation and details on egress IPs * Repurpose proxied-records h2 and update anchor links * Add dedicated folder to move proxying higher on the sidenav * Add dedicated page to proxying limitations * Add Secondary DNS with pre-signed DNSSEC limitation * Explicitly call out DNS-only on pre-signed DNSSEC warning * Replace link to Secondary DNS in limitations.mdx * Small text tweaks for consistency * Call out example where CNAME shouldn't be proxied * Move proxied-dns-records to index.mdx for name consistency * Adjust pcx_content_type accordingly * Improve linkning to Fundamentals from limitations.mdx * Apply PM feedback and improve passive voice * Edit explanation of predefined TTL as per PM comment * Fix links with specific anchors to limitations * Find and replace remaining links that kept valid anchors * Further adjust specific links to #proxied-records * Add redirect from previous buried page to new one * Adding some changes left unstaged * Fix broken links * Apply suggestions from code review Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com> --------- Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>Rebecca Tamachiro · 28cb6c1a · 2025-02-11
- 1.2ETV[Chore] Remove timestamps from changelogs (#23678) * [Chore] Remove timestamps from changelogs * update * style guide tweak * update testKody Jackson · 3be48813 · 2025-07-15
- 1.2ETV[Jun] Updating dashboard instructions with `DashButton`. (#24861) * Updating instructions for Workers KV dashboard instructions * Updating dashbutton for all affected D1 chapters * Updating Hyperdrive chapters with DashButton * Updating R2 chapters dashboard instructions * Catching missed R2 chapters * Catching DO docs * Updating dash instructions for Pages docs * Pushing changes for Workers AI docs * Adding introductory sentence when using the DashButton * Apply suggestions from code review Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com> * Adding button for Workers KV --------- Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com>Jun Lee · d5a484ba · 2025-09-03
- 1.2ETVAdded product & description to frontmatter (#30090)Denise Peña · 5ace1e71 · 2026-04-20
- 1.1ETV[Dev Plat] Added product & description to frontmatter (#30108) * Added product & description to frontmatter * Apply suggestions from code review Co-authored-by: Caley Burton <caley@cloudflare.com> * Update src/content/docs/pulumi/tutorial/index.mdx Co-authored-by: Caley Burton <caley@cloudflare.com> --------- Co-authored-by: Caley Burton <caley@cloudflare.com>Denise Peña · b002c838 · 2026-04-21
- 1.1ETVfirst draft emails improved (#27805) * first draft emails improved * Update sending.mdx * improve based on feedback from thomas desmond * docs: add email headers reference page - New reference doc covering whitelisted headers, platform-controlled headers, validation rules, limits, usage examples, and error codes - Add header error codes to Workers API error codes table - Link headers field in API interface to new reference doc * fix: remove unused Alert import that breaks build * fix: use 'entry' instead of 'product' in directory yaml and add id field The directory schema expects 'entry' not 'product', and requires an 'id' field. Without this, the build fails with 'Cannot read properties of undefined (reading group)' when Head.astro tries to access product.data.entry.group. * docs: remove quarantine system section from deliverability page * docs: remove internal details, pricing, quarantine refs, and WIP labels - Remove all quarantine system references (email-lifecycle, logs) - Remove '(work in progress)' from page titles (domains, metrics, postmaster) - Remove internal timeline note and fix typo in sandboxing partial - Generalize retry intervals and suppression thresholds (internal details) - Reword IP reputation to not expose tiered pool architecture - Remove specific pricing figures - Remove 'not available' contradiction from local dev sending page * docs: remove shared IP pool reference from suppressions * docs: restore shared IP pool wording in suppressions * docs: remove react-email references from email service docs - Delete react-email-templates.mdx example page - Remove React Email Support feature card from index - Remove react field from EmailMessage interface - Remove React Email integration section from Workers API page * docs: add REST API availability and subdomain support - Remove 'Workers binding only' and 'top-level domain required' limitations - Add REST API page with endpoint, auth, and curl example - Link to REST API reference across index, get-started, and API pages - Subdomains are now supported (removed top-level domain restriction) * docs: thoroughly surface REST API across email service docs - Flesh out rest-api.mdx with tabs (simple, multiple recipients, CC/BCC), attachments, custom headers, and error handling sections - Add REST API curl tab as the first tab on the index.mdx landing page - Add 'Send your first email with the REST API' section to get-started - Add REST API curl tab to headers.mdx usage examples - Update workers-api.mdx intro to cross-link REST API as alternative - Update limits.mdx to clarify which limits apply to both APIs vs Workers only - Add REST API note to local-development/sending.mdx - Add REST API context note to examples/email-sending index - Fix stale react: field in workers-api.mdx batch template example - Fix 3 broken links to /email-service/configuration/workers/ * docs: remove non-existent production access limit increase form link * fix: audit and correct email service docs for accuracy across 20 files Cross-referenced docs against fwdr source code, workerd C++ bindings, published API spec, and internal discussions to fix: - API endpoint path: /email-service/send -> /email/sending/send - REST API field names: from.email -> from.address, replyTo -> reply_to - REST API response shape: messageId -> delivered/permanent_bounces/queued - Interface type: EmailBinding -> SendEmail (matches workerd) - Remove sendBatch() (not implemented) - Fix EmailSendResult (no success field, not a class) - Error codes: remove 4 non-existent, add E_RECIPIENT_NOT_ALLOWED - SPF record: _spf.cloudflare.com -> _spf.email.cloudflare.net - Recipients limit: 100 -> 50 (matches MAX_RCPTS) - Remove fictitious hourly/monthly quota columns - Remove default daily limit numbers - DKIM record type: CNAME -> TXT - Add canBeForwarded to ForwardableEmailMessage - Fix legacy /email-routing/ links - Remove sandbox/production access terminology - Add pricing: $0.35 per 1,000 emails - Free plan: can send to account-owned verified addresses - Fix replyAt typo in deliverability docs * Fixing broken link * PCX Review * Migrate more email routing docs to email service * docs: audit and improve email service docs for accuracy - Merge reference/limits into platform/limits, add sending limits section - Fix DNS records to match dashboard: sending records on cf-bounce subdomain, correct SPF (_spf.mx.cloudflare.net), correct DKIM selectors, add sending MX - Update dashboard nav paths: Compute & AI -> Compute, add Email Sending/Routing - Remove global suppression list concept, keep account suppression list only - Remove inaccurate sections (custom sending domains, sender restrictions, multi-domain setup, domain health monitoring) - Add remote bindings (recommended) to local dev sending docs - Fix routing local dev: remove wrong Content-Type header, note Message-ID required - Add rejected status for suppressed emails in logs - Add separate domains best practice to deliverability page - Add redirect for reference/limits -> platform/limits * docs: remove basic sending worker example, remove limits redirect * build pass * Apply suggestions from code review Co-authored-by: Jun Lee <junlee@cloudflare.com> * Apply suggestion from @Oxyjun * Apply suggestion from @Oxyjun --------- Co-authored-by: Jun Lee <junlee@cloudflare.com>Thomas Gauvin · 984af9c7 · 2026-04-16