docs/api-updates.md
When adding new JavaScript APIs to workerd, please remember that all compatibility flags MUST be documented BEFORE their enable date. This is important as users need to understand what they are opting into when they update the date. It is the responsibility of whoever introduces the flag to update the documentation at the same time as the flag.
Compatibility flags and dates for use within Workerd are defined in compatibility-date.capnp.
When you create a Workerd pull request that contains new compatibility definitions, please create a pull request to update Cloudflare docs at the same time.
Compatibility flags should be added to the Cloudflare Workers Compatibility flags documentation.
The cloudflare-docs repository is hosted on GitHub. Compatibility flags are documented in per-feature markdown files under src/content/compatibility-flags.