Create devcontainer.json

.devcontainer/devcontainer.json

@@ -0,0 +1,5 @@
+{
+  "image": "mcr.microsoft.com/devcontainers/universal:2",
+  "features": {
+  }
+}

.editorconfig

@@ -3,11 +3,11 @@ root = true
 
 [*]
 indent_size = 2
-indent_style = space
+indent_style = tab
 end_of_line = lf
 charset = utf-8
 trim_trailing_whitespace = true
 insert_final_newline = false
 
-[Makefile]
-indent_style = tab
+[*.{yml,yaml}]
+indent_style = space

.git-blame-ignore-revs

@@ -0,0 +1,2 @@
+# Migration from Hugo -> Starlight
+abb2df90da1a9d8544ec51f7638b10d007ba45b1

.gitattributes

@@ -0,0 +1,22 @@
+*.astro text eol=lf
+*.css text eol=lf
+*.go text eol=lf
+*.html text eol=lf
+*.ini text eol=lf
+*.js text eol=lf
+*.json text eol=lf
+*.md text eol=lf
+*.mdx text eol=lf
+*.mjs text eol=lf
+*.svg text eol=lf
+*.toml text eol=lf
+*.ts text eol=lf
+*.txt text eol=lf
+*.vue text eol=lf
+*.xml text eol=lf
+*.yaml text eol=lf
+*.yml text eol=lf
+_redirects text eol=lf
+.editorconfig text eol=lf
+.gitattributes text eol=lf
+.prettierignore text eol=lf

.gitguardian.yml

@@ -0,0 +1,5 @@
+version: 2
+secret:
+  ignored-paths:
+    - "assets/search.ts"
+    - "data/*.yml"

.github/ISSUE_TEMPLATE/config.yml

@@ -1 +1,11 @@
 blank_issues_enabled: false
+contact_links:
+  - name: Issue with your website
+    url: https://developers.cloudflare.com/support/contacting-cloudflare-support/#methods-of-contacting-cloudflare-support
+    about: If you need support with your website or Cloudflare applications, please contact Cloudflare through the relevant support channel.
+  - name: Issue with Cloudflare 5XX errors
+    url: https://developers.cloudflare.com/support/troubleshooting/cloudflare-errors/troubleshooting-cloudflare-5xx-errors/#troubleshooting-cloudflare-5xx-errors--cloudflare-help-center
+    about: If you are encountering a Cloudflare 5XX error, please read our troubleshooting documentation for 5XX errors.
+  - 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.

.github/ISSUE_TEMPLATE/content.add.yml

@@ -2,62 +2,16 @@ name: Request content addition
 description: Request NEW documentation content.
 labels: ["documentation", "content:new"]
 body:
-  - type: dropdown
-    id: products
+  - type: textarea
+    id: location-urls
     validations:
       required: true
     attributes:
-      label: Which Cloudflare product(s) does this pertain to?
-      multiple: true
-      options:
-        - "1.1.1.1"
-        - Analytics
-        - API
-        - API Shield
-        - Automatic Platform Optimization
-        - Bots
-        - BYOIP
-        - Cache
-        - China Network
-        - Client IP Geolocation
-        - Cloudflare One
-        - DDoS Protection
-        - DNS
-        - Email Routing
-        - Firewall
-        - Fundamentals
-        - HTTP/3
-        - Image Optimization
-        - Load Balancing
-        - Logs
-        - Magic Firewall
-        - Magic Transit
-        - Magic WAN
-        - Network Error Logging
-        - Network Interconnect
-        - Page Shield
-        - Pages
-        - Partners
-        - Pub/Sub
-        - R2
-        - Railgun
-        - Randomness Beacon
-        - Registrar
-        - Rules
-        - Ruleset Engine
-        - Security Center
-        - Spectrum
-        - SSL
-        - Stream
-        - Tenant
-        - Terraform
-        - Time Services
-        - WAF
-        - Waiting Room
-        - WARP Client
-        - Web3
-        - Workers
-        - Zaraz
+      label: Proposed changes
+      description: Provide links to the top-level section of `https://developers.cloudflare.com/` or specific proposed pages.
+      placeholder: |
+        - https://developers.cloudflare.com/cloudflare-one/
+        - https://developers.cloudflare.com/workers/examples/
 
   - type: input
     id: subject
@@ -78,11 +32,10 @@ body:
         Where would you expect this addition to be placed?
         Please provide any URLs to existing documents.
 
-
   - type: textarea
     id: extra
     validations:
       required: false
     attributes:
       label: Additional information
-      description: Any other details or screenshots that may be relevant.
+      description: Any other details or screenshots that may be relevant.

.github/ISSUE_TEMPLATE/content.edit.yml

@@ -2,102 +2,32 @@ name: Request content update
 description: Request documentation content edits and/or clarifications.
 labels: ["documentation", "content:edit"]
 body:
-  - type: dropdown
-    id: products
-    validations:
-      required: true
-    attributes:
-      label: Which Cloudflare product does this pertain to?
-      options:
-        - "1.1.1.1"
-        - Analytics
-        - API
-        - API Shield
-        - Automatic Platform Optimization
-        - Bots
-        - BYOIP
-        - Cache
-        - China Network
-        - Client IP Geolocation
-        - Cloudflare One
-        - DDoS Protection
-        - DNS
-        - Email Routing
-        - Firewall
-        - Fundamentals
-        - HTTP/3
-        - Image Optimization
-        - Load Balancing
-        - Logs
-        - Magic Firewall
-        - Magic Transit
-        - Magic WAN
-        - Network Error Logging
-        - Network Interconnect
-        - Page Shield
-        - Pages
-        - Partners
-        - Pub/Sub
-        - R2
-        - Railgun
-        - Randomness Beacon
-        - Registrar
-        - Rules
-        - Ruleset Engine
-        - Security Center
-        - Spectrum
-        - SSL
-        - Stream
-        - Tenant
-        - Terraform
-        - Time Services
-        - WAF
-        - Waiting Room
-        - WARP Client
-        - Web3
-        - Workers
-        - Zaraz
-
   - type: textarea
     id: location-urls
     validations:
       required: true
     attributes:
       label: Existing documentation URL(s)
-      description: Please provide links to existing `https://developers.cloudflare.com/` pages.
+      description: Provide links to existing `https://developers.cloudflare.com/` pages.
       placeholder: |
         - https://developers.cloudflare.com/...
         - https://developers.cloudflare.com/...
 
-  - type: textarea
-    id: location-section
-    validations:
-      required: true
-    attributes:
-      label: Section that requires update
-      description: Please specify which section requires the update.
-      placeholder: Please name or describe the section as not all page sections have header-links and section IDs may change over time.
-
   - type: textarea
     id: subject-what
     validations:
       required: true
     attributes:
-      label: What needs to change?
-      description: Explain the issue with the content, including any confusion it may be causing.
-
-  - type: textarea
-    id: subject-how
-    validations:
-      required: true
-    attributes:
-      label: How should it change?
-      description: For content clarification requests, please propose a way forward that would have helped you avoid any confusion.
+      label: What changes are you suggesting?
+      description: |
+        - Give as much detail as you can to help us understand the change you want to see.
+        - Why should the docs be changed? What use cases does it support?
+        - What is the expected outcome?
 
   - type: textarea
     id: extra
     validations:
       required: false
     attributes:
       label: Additional information
-      description: Any other details or screenshots that may be relevant.
+      description: Any other details or screenshots that may be relevant.