Skip to content

Conversation

@dario-piotrowicz
Copy link
Member

Fixes https://jira.cfdata.org/browse/DEVX-215

The changes here:

  • augment the Claude changeset review to ensure that experimental features are handled appropriately
  • documents that we recommend using the Cloudflare SDK to interact with the Cloudflare REST API

  • Tests
    • Tests included/updated
    • Automated tests not possible - manual testing has been completed as follows:
    • Additional testing not necessary because: infra + docs changes only
  • Public documentation
    • Cloudflare docs PR(s):
    • Documentation not necessary because: infra + docs changes only

A picture of a cute animal (not mandatory, but encouraged)

@dario-piotrowicz dario-piotrowicz requested a review from a team as a code owner January 15, 2026 11:56
@changeset-bot
Copy link

changeset-bot bot commented Jan 15, 2026

⚠️ No Changeset found

Latest commit: f55c3cc

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@pkg-pr-new
Copy link

pkg-pr-new bot commented Jan 15, 2026

create-cloudflare

npm i https://pkg.pr.new/create-cloudflare@11938

@cloudflare/kv-asset-handler

npm i https://pkg.pr.new/@cloudflare/kv-asset-handler@11938

miniflare

npm i https://pkg.pr.new/miniflare@11938

@cloudflare/pages-shared

npm i https://pkg.pr.new/@cloudflare/pages-shared@11938

@cloudflare/unenv-preset

npm i https://pkg.pr.new/@cloudflare/unenv-preset@11938

@cloudflare/vite-plugin

npm i https://pkg.pr.new/@cloudflare/vite-plugin@11938

@cloudflare/vitest-pool-workers

npm i https://pkg.pr.new/@cloudflare/vitest-pool-workers@11938

@cloudflare/workers-editor-shared

npm i https://pkg.pr.new/@cloudflare/workers-editor-shared@11938

@cloudflare/workers-utils

npm i https://pkg.pr.new/@cloudflare/workers-utils@11938

wrangler

npm i https://pkg.pr.new/wrangler@11938

commit: f55c3cc

3. **Markdown Headers**: No h1/h2/h3 headers (breaks changelog formatting)
4. **Analytics**: If the change collects more analytics, it should be a minor even though there is no user-visible change
5. **Dependabot**: Do not validate dependency update changesets for create-cloudflare
6. **Experimental features**: If some experimental feature is being introduced, make sure that if the feature is part of the Wrangler CLI than it is behind an experimental flag (as described in the "Experimental Flags" section of `./packages/wrangler/CONTRIBUTING.md`). If the feature is not part of the Wrangler CLI make sure that it is disabled by default and that it can be enabled by some configuration that clearly represents the experimental nature of the feature.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this the right job to be detecting this? The aim of this job is to check changesets, not general practices in PRs.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yeah I agree... I think this is ok since we validate the presence of a changeset and if someone is adding an experimental feature they should include the way to opt-in into it in the changeset, however if we prefer I can take a different approach

do you have anything in mind? like having a different CI check where Claude reviews all the changes instead of just the changeset ones?


### Integration with Cloudflare REST API

The [Cloudflare REST API](https://developers.cloudflare.com/api/) whenever possible should not be interacted directly with, the [Cloudflare TypeScript SDK](https://www.npmjs.com/package/cloudflare) package should be used instead. This helps maintaining the code more type safe and concise as well as preventing the usage of undocumented and unstable features that might be present in the raw REST API.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@penalosa had a different view last time I checked?

…experimental features are appropriately handled

simplify Claude requirement for experimental features
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Status: Untriaged

Development

Successfully merging this pull request may close these issues.

3 participants