Merge

.github/CODEOWNERS

@@ -21,20 +21,20 @@
 # AI
 
 /src/content/docs/agents/ @irvinebroque @rita3ko @elithrar @thomasgauvin @threepointone @cloudflare/pcx-technical-writing
-/src/content/docs/ai-gateway/ @kathayl @G4brym @mchenco @daisyfaithauma @cloudflare/pcx-technical-writing
+/src/content/docs/ai-gateway/ @kathayl @mchenco @daisyfaithauma @cloudflare/pcx-technical-writing
 /src/content/docs/workers-ai/ @rita3ko @craigsdennis @markdembo @mchenco @daisyfaithauma @cloudflare/pcx-technical-writing
 /src/content/docs/vectorize/ @elithrar @vy-ton @sejoker @mchenco @cloudflare/pcx-technical-writing
 /src/content/partials/vectorize/ @elithrar @mchenco @sejoker @cloudflare/pcx-technical-writing
-/src/content/release-notes/workers-ai.yaml @kathayl @G4brym @mchenco @daisyfaithauma @cloudflare/pcx-technical-writing
-/src/content/release-notes/ai-gateway.yaml @kathayl @G4brym @mchenco @daisyfaithauma @cloudflare/pcx-technical-writing
+/src/content/release-notes/workers-ai.yaml @kathayl @mchenco @daisyfaithauma @cloudflare/pcx-technical-writing
+/src/content/release-notes/ai-gateway.yaml @kathayl @mchenco @daisyfaithauma @cloudflare/pcx-technical-writing
 /src/content/release-notes/vectorize.yaml @elithrar @mchenco @sejoker @cloudflare/pcx-technical-writing
 /src/content/docs/autorag/ @rita3ko @irvinebroque @aninibread @ToriLindsay @cloudflare/pcx-technical-writing
 
 # Analytics & Logs
 
-/src/content/docs/analytics/ @46bit @jherre @jimhawkridge @soheiokamoto @victor-perov @angelampcosta @cloudflare/pcx-technical-writing
+/src/content/docs/analytics/ @jimhawkridge @soheiokamoto @angelampcosta @cloudflare/pcx-technical-writing
 /src/content/docs/data-localization/ @soheiokamoto @angelampcosta @cloudflare/pcx-technical-writing
-/src/content/docs/logs/ @jherre @soheiokamoto @victor-perov @angelampcosta @cloudflare/pcx-technical-writing
+/src/content/docs/logs/ @soheiokamoto @angelampcosta @cloudflare/pcx-technical-writing
 
 # API & Zones
 
@@ -45,12 +45,12 @@
 
 # Browser Rendering API
 
-/src/content/docs/browser-rendering/ @mchenco @cloudflare/pcx-technical-writing @celso @meddulla @danielgek @kathayl
+/src/content/docs/browser-rendering/ @mchenco @cloudflare/pcx-technical-writing @celso @danielgek @kathayl
 
 # Changelogs
 
-/src/content/changelog/ @cloudflare/pm-changelogs
-/src/assets/images/changelog/ @cloudflare/pm-changelogs
+/src/content/changelog/ @cloudflare/pm-changelogs @cloudflare/pcx-cloudflare-one
+/src/assets/images/changelog/ @cloudflare/pm-changelogs @cloudflare/pcx-cloudflare-one
 /src/assets/images/ @cloudflare/pm-changelogs @cloudflare/pcx-technical-writing
 
 # Cloudflare One
@@ -114,8 +114,8 @@
 /src/content/release-notes/kv.yaml @elithrar @thomasgauvin @rts-rob @oxyjun @cloudflare/pcx-technical-writing
 /src/content/partials/kv/ @elithrar @thomasgauvin @rts-rob @oxyjun @cloudflare/pcx-technical-writing
 /src/content/docs/pub-sub/ @elithrar @dcpena @cloudflare/pcx-technical-writing
-/src/content/docs/queues/ @elithrar @toddmantell @maheshwarip @harshil1712 @cloudflare/pcx-technical-writing
-/src/content/release-notes/queues.yaml @elithrar @toddmantell @maheshwarip @cloudflare/pcx-technical-writing
+/src/content/docs/queues/ @elithrar @maheshwarip @harshil1712 @cloudflare/pcx-technical-writing
+/src/content/release-notes/queues.yaml @elithrar @maheshwarip @cloudflare/pcx-technical-writing
 /src/content/docs/r2/ @oxyjun @elithrar @jonesphillip @harshil1712 @cloudflare/workers-docs @cloudflare/pcx-technical-writing
 /src/content/release-notes/r2.yaml @oxyjun @elithrar @cloudflare/workers-docs @cloudflare/pcx-technical-writing
 /src/content/docs/stream/ @tsmith512 @dcpena @cloudflare/pcx-technical-writing @renandincer @third774
@@ -136,21 +136,21 @@
 /src/content/docs/workers/reference/migrate-to-module-workers.mdx @irvinebroque @GregBrimble @ToriLindsay @cloudflare/deploy-config @cloudflare/pcx-technical-writing
 /src/content/docs/workers/reference/security-model.mdx @irvinebroque @GregBrimble @ToriLindsay @cloudflare/pcx-technical-writing
 /src/content/compatibility-flags/ @irvinebroque @mikenomitch @GregBrimble @cloudflare/pcx-technical-writing
-/src/content/docs/workers/wrangler/ @cloudflare/wrangler @cloudflare/wrangler-friends @irvinebroque @ToriLindsay @cloudflare/pcx-technical-writing
+/src/content/docs/workers/wrangler/ @cloudflare/wrangler @irvinebroque @ToriLindsay @cloudflare/pcx-technical-writing
 /src/content/docs/workers/frameworks/ @igorminar @cloudflare/wrangler @aninibread @GregBrimble @ToriLindsay @cloudflare/pcx-technical-writing
 /src/content/docs/pages/framework-guides/ @igorminar @cloudflare/wrangler @aninibread @GregBrimble @ToriLindsay @cloudflare/pcx-technical-writing
 /src/content/docs/analytics/analytics-engine/ @irvinebroque @elithrar @cloudflare/pcx-technical-writing
 /src/content/docs/cloudflare-for-platforms/workers-for-platforms/ @irvinebroque @angelampcosta @GregBrimble @cloudflare/deploy-config @cloudflare/pcx-technical-writing
 /src/content/docs/workers/observability/ @irvinebroque @mikenomitch @rohinlohe @ToriLindsay @cloudflare/pcx-technical-writing
 /src/content/docs/workers/static-assets @irvinebroque @GregBrimble @WalshyDev @ToriLindsay @cloudflare/deploy-config @cloudflare/pcx-technical-writing
-/src/content/docs/workflows/ @elithrar @celso @sidharthachatterjee @cloudflare/pcx-technical-writing
+/src/content/docs/workflows/ @elithrar @celso @cloudflare/pcx-technical-writing
 
 # DDoS Protection
 
 /src/content/docs/ddos-protection/ @patriciasantaana @cloudflare/pcx-technical-writing
-/src/content/docs/ddos-protection/change-log/ @antoinecordelle @patriciasantaana @cloudflare/pcx-technical-writing
-/src/content/release-notes/ddos-http.yaml @antoinecordelle @patriciasantaana @cloudflare/pcx-technical-writing
-/src/content/release-notes/ddos-network.yaml @antoinecordelle @patriciasantaana @cloudflare/pcx-technical-writing
+/src/content/docs/ddos-protection/change-log/ @patriciasantaana @cloudflare/pcx-technical-writing
+/src/content/release-notes/ddos-http.yaml @patriciasantaana @cloudflare/pcx-technical-writing
+/src/content/release-notes/ddos-network.yaml @patriciasantaana @cloudflare/pcx-technical-writing
 
 # Docs team areas
 
@@ -160,7 +160,7 @@
 # Magic products
 
 /src/content/docs/magic-transit/ @marciocloudflare @cloudflare/pcx-technical-writing
-/src/content/docs/magic-firewall/ @arges @Maddy-Cloudflare @cloudflare/pcx-technical-writing
+/src/content/docs/magic-firewall/ @Maddy-Cloudflare @cloudflare/pcx-technical-writing
 /src/content/docs/magic-network-monitoring/ @marciocloudflare @cloudflare/pcx-technical-writing
 /src/content/docs/magic-wan/ @marciocloudflare @cloudflare/pcx-technical-writing
 /src/content/docs/magic-cloud-networking/ @marciocloudflare @cloudflare/pcx-technical-writing
@@ -183,13 +183,13 @@
 
 # Privacy
 
-/src/content/docs/key-transparency/ @cloudflare/privacy @cloudflare/pcx-technical-writing
-/src/content/docs/privacy-gateway/ @cloudflare/privacy @cloudflare/pcx-technical-writing
+/src/content/docs/key-transparency/ @cloudflare/pcx-technical-writing
+/src/content/docs/privacy-gateway/ @cloudflare/pcx-technical-writing
 
 # Radar
 
-/src/content/docs/radar/ @meddulla @G4brym @tiagoad @andre-j3sus @cloudflare/pcx-technical-writing
-/src/content/release-notes/radar.yaml @meddulla @G4brym @tiagoad @andre-j3sus @cloudflare/pcx-technical-writing
+/src/content/docs/radar/ @tiagoad @andre-j3sus @cloudflare/pcx-technical-writing
+/src/content/release-notes/radar.yaml @tiagoad @andre-j3sus @cloudflare/pcx-technical-writing
 
 # Reference architecture
 
@@ -212,8 +212,8 @@
 
 # Support
 
-/src/content/docs/support/ @shanecloudflare @zeinjaber @TracyCloudflare @ngayerie @cloudflare/pcx-technical-writing @cloudflare/customer-support
-/src/assets/images/support/ @shanecloudflare @zeinjaber @TracyCloudflare @ngayerie @cloudflare/pcx-technical-writing @cloudflare/customer-support
+/src/content/docs/support/ @zeinjaber @TracyCloudflare @ngayerie @cloudflare/pcx-technical-writing @cloudflare/customer-support
+/src/assets/images/support/ @zeinjaber @TracyCloudflare @ngayerie @cloudflare/pcx-technical-writing @cloudflare/customer-support
 
 # Turnstile
 

.github/ISSUE_TEMPLATE/config.yml

@@ -6,6 +6,9 @@ contact_links:
   - name: Issue with Cloudflare 5XX errors
     url: https://developers.cloudflare.com/support/troubleshooting/http-status-codes/cloudflare-5xx-errors/
     about: If you are encountering a Cloudflare 5XX error, please read our troubleshooting documentation for 5XX errors.
+  - name: Issue with Workers AI
+    url: https://discord.com/channels/595317990191398933/1105477009964027914
+    about: Issues relating to Workers AI models should be raised in our Developer Discord.
   - name: Issue with Cloudflare Workers
     url: https://github.com/cloudflare/workers-sdk/issues/new/choose
     about: Issues relating to Cloudflare Workers should be made in the workers-sdk repo.

.hyperlint/.vale.ini

@@ -1,4 +1,4 @@
-StylesPath = ../.github/styles
+StylesPath = automations/styles
 MinAlertLevel = suggestion
 IgnoredScopes = code, tt, img
 SkippedScopes = script, style, pre, figure, code
@@ -17,4 +17,4 @@ Vale.Spelling = NO
 
 [*.yaml]
 BasedOnStyles = Vale, cloudflare, cloudflare-automation
-Vale.Spelling = NO
+Vale.Spelling = NO

.hyperlint/automations/styles/cloudflare-automation/EOLWhitespace.yml

@@ -0,0 +1,12 @@
+---
+name: gitlab_base.EOLWhitespace
+description: |
+  Checks that there is no useless whitespace at the end of lines.
+extends: existence
+message: "Remove whitespace characters from the end of the line."
+link: https://docs.gitlab.com/development/documentation/styleguide/
+vocab: false
+level: warning
+scope: raw
+raw:
+  - ' +\n'

.hyperlint/automations/styles/cloudflare-automation/ExclamationMarks.yml

@@ -0,0 +1,12 @@
+extends: existence
+message: "Don't use exclamation points in text."
+link: "https://developers.google.com/style/exclamation-points"
+nonword: true
+level: error
+action:
+  name: edit
+  params:
+    - trim_right
+    - "!"
+tokens:
+  - '\w+!(?:\s|$)'

.hyperlint/automations/styles/cloudflare-automation/HeadingLinks.yml

@@ -0,0 +1,17 @@
+---
+name: gitlab_base.HeadingLink
+description: |
+  Do not include links in a heading.
+  Headings already have self-referencing anchor links,
+  and they're used for generating the table of contents.
+  Adding a link will break the anchor linking behavior.
+extends: existence
+message: "Do not use links in headings."
+vocab: false
+level: error
+ignorecase: true
+nonword: true
+link: https://docs.gitlab.com/development/documentation/styleguide/#links
+scope: raw
+tokens:
+  - ^#+ .*\[.+\]\(\S+\).*$

.hyperlint/automations/styles/cloudflare-automation/HeadingPunctuation.yml

@@ -0,0 +1,13 @@
+extends: existence
+message: "Don't use end punctuation in headings."
+link: https://docs.microsoft.com/en-us/style-guide/punctuation/periods
+nonword: true
+level: warning
+scope: heading
+action:
+  name: edit
+  params:
+    - trim_right
+    - ".?!"
+tokens:
+  - "[a-z][.?!]$"

.hyperlint/automations/styles/cloudflare-automation/HeadingsSentenceCase.yml

@@ -0,0 +1,28 @@
+extends: capitalization
+message: "'%s' should use sentence-style capitalization."
+link: https://docs.microsoft.com/en-us/style-guide/capitalization
+level: suggestion
+scope: heading
+match: $sentence
+indicators:
+  - ":"
+exceptions:
+  - Azure
+  - CLI
+  - Code
+  - Cosmos
+  - Docker
+  - Emmet
+  - I
+  - Kubernetes
+  - Linux
+  - macOS
+  - Marketplace
+  - MongoDB
+  - REPL
+  - Studio
+  - TypeScript
+  - URLs
+  - Visual
+  - VS
+  - Windows

.hyperlint/automations/styles/cloudflare-automation/NonStandardQuotes.yml

@@ -0,0 +1,14 @@
+---
+# Warning: cloudflare.NonStandardQuotes
+#
+# Use only standard single and double quotes, not left or right quotes.
+#
+# For a list of all options, see https://vale.sh/docs/topics/styles/
+extends: existence
+message: "Use standard single quotes or double quotes only. Do not use left or right quotes."
+level: warning
+ignorecase: true
+link: https://developers.cloudflare.com/style-guide/grammar/punctuation-marks-and-symbols/quotation-marks/
+scope: raw
+raw:
+  - "[‘’“”]"

.hyperlint/automations/styles/cloudflare-automation/UnclearAntecedent.yml

@@ -0,0 +1,21 @@
+---
+name: gitlab_base.UnclearAntecedent
+description: |
+  Checks for words that need a noun for clarity.
+extends: existence
+message: "Instead of '%s', try starting this sentence with a specific subject and verb."
+link: https://docs.gitlab.com/development/documentation/styleguide/word_list/#this-these-that-those
+vocab: false
+level: warning
+ignorecase: false
+tokens:
+  - "That is"
+  - "That was"
+  - "There are"
+  - "There were"
+  - "These are"
+  - "These were"
+  - "This is"
+  - "This was"
+  - "Those are"
+  - "Those were"

.hyperlint/automations/styles/cloudflare/Contractions.yml

@@ -0,0 +1,57 @@
+---
+# Error: cloudflare.Contractions
+#
+# Do not use contractions.
+#
+# For a list of all options, see https://vale.sh/docs/topics/styles/
+
+extends: substitution
+message: "Use '%s' instead of '%s'."
+link: https://developers.cloudflare.com/style-guide/grammar/parts-of-speech/contractions/
+level: error
+ignorecase: true
+action:
+  name: replace
+swap:
+  are not: aren't
+  cannot: can't
+  could not: couldn't
+  did not: didn't
+  do not: don't
+  does not: doesn't
+  has not: hasn't
+  have not: haven't
+  how is: how's
+  is not: isn't
+
+  'it is(?!\.)': it's
+  'it''s(?=\.)': it is
+
+  should not: shouldn't
+
+  "that is(?![.,])": that's
+  'that''s(?=\.)': that is
+
+  'they are(?!\.)': they're
+  'they''re(?=\.)': they are
+
+  was not: wasn't
+
+  'we are(?!\.)': we're
+  'we''re(?=\.)': we are
+
+  'we have(?!\.)': we've
+  'we''ve(?=\.)': we have
+
+  were not: weren't
+
+  'what is(?!\.)': what's
+  'what''s(?=\.)': what is
+
+  'when is(?!\.)': when's
+  'when''s(?=\.)': when is
+
+  'where is(?!\.)': where's
+  'where''s(?=\.)': where is
+
+  will not: won't

.hyperlint/automations/styles/cloudflare/InclusiveLanguage.yml

@@ -0,0 +1,22 @@
+---
+# Warning: cloudflare.InclusiveLanguage
+#
+# Suggests alternatives for words that are culturally inappropriate.
+#
+# For a list of all options, see https://vale.sh/docs/topics/styles/
+
+extends: substitution
+message: "**Warning**: Use inclusive language. Consider '%s' instead of '%s'."
+level: warning
+ignorecase: true
+swap:
+  blacklist(?:ed|ing|s)?: denylist
+  whitelist(?:ed|ing|s)?: allowlist
+  master: primary, main
+  slave: secondary
+  he: they
+  his: their
+  she: they
+  hers: their
+  sanity (?:check|test): check for completeness
+  dummy: placeholder, sample, fake

.hyperlint/automations/styles/cloudflare/LatinTerms.yml

@@ -0,0 +1,17 @@
+---
+# Warning: cloudflare.LatinTerms
+#
+# Checks for use of Latin terms.
+# Uses https://github.com/errata-ai/Google/blob/master/Google/Latin.yml for ideas.
+#
+# For a list of all options, see https://vale.sh/docs/topics/styles/
+
+extends: substitution
+message: "Use '%s' instead of '%s', but consider rewriting the sentence."
+link: https://developers.cloudflare.com/style-guide/grammar/parts-of-speech/abbreviations/#ie-vs-eg
+level: warning
+nonword: true
+ignorecase: true
+swap:
+  '\b(?:e\.?g[\s.,;:])': for example
+  '\b(?:i\.?e[\s.,;:])': that is

.hyperlint/automations/styles/cloudflare/LinkChecks.yml

@@ -0,0 +1,15 @@
+---
+# Warning: cloudflare.LinkChecks
+#
+# Checks for the presence of semantically unhelpful words in link text.
+#
+# For a list of all options, see https://vale.sh/docs/topics/styles/
+extends: existence
+message: "**Warning**: When referring to another page in our docs, use the full relative link (`/1.1.1.1/check/`) instead of the full URL (`https://developers.cloudflare.com/1.1.1.1/check/`) or a local development link (`http://localhost:1111/1.1.1.1/check/`)."
+level: warning
+ignorecase: true
+scope: raw
+nonword: true
+tokens:
+  - \[.*\]\(https?:\/\/developers\.cloudflare\.com\/.+\)
+  - \[.*\]\(https?:\/\/localhost:1111\/.*?\)

.hyperlint/automations/styles/cloudflare/MeaningfulLinkWords.yml

@@ -0,0 +1,16 @@
+---
+# Warning: cloudflare.MeaningfulLinkWords
+#
+# Checks for the presence of semantically unhelpful words in link text.
+#
+# For a list of all options, see https://vale.sh/docs/topics/styles/
+extends: existence
+message: "**Warning**: Rewrite the link text for `%s` to be more descriptive. For more information, refer to [Descriptive link text](https://developers.cloudflare.com/style-guide/formatting/structure/links/#descriptive-link-text)."
+level: warning
+ignorecase: true
+scope: raw
+nonword: true
+tokens:
+  - \[here\]\(.*\)
+  - \[this page\]\(.*\)
+  - \[read more\]\(.*\)