From 8cf56422cb0a82097a1340cf21199c21b8019a84 Mon Sep 17 00:00:00 2001 From: kodster28 Date: Tue, 11 Mar 2025 15:28:39 -0500 Subject: [PATCH 01/11] [Docs site] Tags allowlist --- src/schemas/tags.ts | 109 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 109 insertions(+) create mode 100644 src/schemas/tags.ts diff --git a/src/schemas/tags.ts b/src/schemas/tags.ts new file mode 100644 index 00000000000000..8a2be7ba245387 --- /dev/null +++ b/src/schemas/tags.ts @@ -0,0 +1,109 @@ +const data_structures: Array = [ + { label: "JSON" }, + { label: "TOML" }, + { label: "XML" }, + { label: "YAML" }, +]; + +const frameworks: Array = [ + { label: "Angular" }, + { label: "Astro" }, + { label: "Hono" }, + { label: "Next.js", variants: ["nextjs"] }, + { label: "Node.js", variants: ["node", "nodejs"] }, + { label: "Nuxt" }, + { label: "Ruby", variants: ["rb", "ruby on rails"] }, + { label: "Svelte" }, + { label: "SvelteKit" }, + { label: "Vue.js", variants: ["vue", "vuejs"] }, +]; + +const integrations: Array = [ + { label: "Azure", variants: ["Microsoft Azure", "MS Azure"] }, + { label: "AWS", variants: ["Amazon Web Services"] }, + { label: "GCP", variants: ["Google Cloud", "Google Cloud Platform"] }, + { label: "G Suite Groupe", variants: ["gsuite", "g suite"] }, + { label: "GitHub" }, + { + label: "Microsoft Entra ID", + variants: ["AzureAD", "Azure Active Directory", "MS Entra ID", "Entra ID"], + }, + { label: "Postgres", variants: ["PostgresSQL"] }, + { label: "S3" }, + { label: "Sentry" }, + { label: "Stripe" }, + { label: "Sumo Logic", variants: ["sumo"] }, + { label: "Okta" }, + { label: "WordPress" }, +]; + +const languages: Array = [ + { label: "Go" }, + { label: "GraphQL" }, + { label: "JavaScript", variants: ["js"] }, + { label: "MySQL" }, + { label: "NoSQL" }, + { label: "PowerShell", variants: ["js"] }, + { label: "Python", variants: ["py"] }, + { label: "RPC" }, + { label: "Rust", variants: ["rs"] }, + { label: "SQL" }, + { label: "TypeScript", variants: ["ts"] }, + { label: "WebAssembly", variants: ["Web Assembly", "wasm"] }, +]; + +const protocols: Array = [ + { label: "FTP", variants: ["file transfer protocol"] }, + { label: "IPsec" }, + { label: "IPv4" }, + { label: "IPv6" }, + { label: "JSON web token (JWT)", variants: ["jwt"] }, + { label: "MASQUE" }, + { label: "NetFlow" }, + { label: "MQTT" }, + { label: "RDP" }, + { label: "SAML" }, + { label: "SCIM" }, + { label: "SMTP" }, + { label: "SSH" }, + { label: "UDP" }, + { label: "WebSockets", variants: ["websocket"] }, + { label: "Wireguard" }, +]; + +const operating_systems: Array = [ + { label: "Linux" }, + { label: "MacOS", variants: ["OS X"] }, + { label: "Windows", variants: ["ms windows"] }, +]; + +const use_cases: Array = [ + { label: "Authentication", variants: ["auth"] }, + { label: "A/B testing", variants: ["ab test"] }, + { label: "Caching", variants: ["cache"] }, + { label: "CMS" }, + { label: "Cookies" }, + { label: "Debugging", variants: ["debug"] }, + { label: "Forms" }, + { label: "Geolocation" }, + { label: "HTMLRewriter" }, + { label: "Headers", variants: ["header"] }, + { label: "Localization" }, + { label: "Logging" }, + { label: "Middleware" }, + { label: "Playback" }, + { label: "Redirects", variants: ["redirect"] }, + { label: "Request modification", variants: ["request"] }, + { label: "Response modification", variants: ["response"] }, + { label: "URL rewrite", variants: ["rewrite"] }, +]; + +export const tags = { + data_structures, + frameworks, + integrations, + languages, + protocols, + operating_systems, + use_cases, +}; From 0522b0ec14a0c516c28a58c8272a23c274191b24 Mon Sep 17 00:00:00 2001 From: kodster28 Date: Tue, 11 Mar 2025 15:32:03 -0500 Subject: [PATCH 02/11] remove old english --- src/schemas/tags.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/schemas/tags.ts b/src/schemas/tags.ts index 8a2be7ba245387..27423a878d4f88 100644 --- a/src/schemas/tags.ts +++ b/src/schemas/tags.ts @@ -22,7 +22,7 @@ const integrations: Array = [ { label: "Azure", variants: ["Microsoft Azure", "MS Azure"] }, { label: "AWS", variants: ["Amazon Web Services"] }, { label: "GCP", variants: ["Google Cloud", "Google Cloud Platform"] }, - { label: "G Suite Groupe", variants: ["gsuite", "g suite"] }, + { label: "G Suite Group", variants: ["gsuite", "g suite"] }, { label: "GitHub" }, { label: "Microsoft Entra ID", From 2c3a66f08bdd91168eb78c5f4a9ec40b5f86c5be Mon Sep 17 00:00:00 2001 From: kodster28 Date: Tue, 11 Mar 2025 15:37:27 -0500 Subject: [PATCH 03/11] tweaks --- src/schemas/tags.ts | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/src/schemas/tags.ts b/src/schemas/tags.ts index 27423a878d4f88..d6a203a21595f2 100644 --- a/src/schemas/tags.ts +++ b/src/schemas/tags.ts @@ -12,10 +12,12 @@ const frameworks: Array = [ { label: "Next.js", variants: ["nextjs"] }, { label: "Node.js", variants: ["node", "nodejs"] }, { label: "Nuxt" }, + { label: "RPC" }, { label: "Ruby", variants: ["rb", "ruby on rails"] }, { label: "Svelte" }, { label: "SvelteKit" }, { label: "Vue.js", variants: ["vue", "vuejs"] }, + { label: "Web Crypto", variants: ["webcrypto"] }, ]; const integrations: Array = [ @@ -45,7 +47,6 @@ const languages: Array = [ { label: "NoSQL" }, { label: "PowerShell", variants: ["js"] }, { label: "Python", variants: ["py"] }, - { label: "RPC" }, { label: "Rust", variants: ["rs"] }, { label: "SQL" }, { label: "TypeScript", variants: ["ts"] }, @@ -95,6 +96,7 @@ const use_cases: Array = [ { label: "Redirects", variants: ["redirect"] }, { label: "Request modification", variants: ["request"] }, { label: "Response modification", variants: ["response"] }, + { label: "Security" }, { label: "URL rewrite", variants: ["rewrite"] }, ]; From 032510de72f324d1545645b772171dbb01e89081 Mon Sep 17 00:00:00 2001 From: kodster28 Date: Tue, 11 Mar 2025 15:40:30 -0500 Subject: [PATCH 04/11] Tweaks --- src/schemas/tags.ts | 2 ++ 1 file changed, 2 insertions(+) diff --git a/src/schemas/tags.ts b/src/schemas/tags.ts index d6a203a21595f2..dff314efb102ac 100644 --- a/src/schemas/tags.ts +++ b/src/schemas/tags.ts @@ -60,6 +60,7 @@ const protocols: Array = [ { label: "IPv6" }, { label: "JSON web token (JWT)", variants: ["jwt"] }, { label: "MASQUE" }, + { label: "mTLS" }, { label: "NetFlow" }, { label: "MQTT" }, { label: "RDP" }, @@ -84,6 +85,7 @@ const use_cases: Array = [ { label: "Caching", variants: ["cache"] }, { label: "CMS" }, { label: "Cookies" }, + { label: "CORS" }, { label: "Debugging", variants: ["debug"] }, { label: "Forms" }, { label: "Geolocation" }, From 0b40340385ff00c41ad5c65d7dcd00bb119e6314 Mon Sep 17 00:00:00 2001 From: kodster28 Date: Tue, 11 Mar 2025 15:42:59 -0500 Subject: [PATCH 05/11] update object casing --- src/schemas/tags.ts | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/src/schemas/tags.ts b/src/schemas/tags.ts index dff314efb102ac..5588563e213c63 100644 --- a/src/schemas/tags.ts +++ b/src/schemas/tags.ts @@ -1,11 +1,11 @@ -const data_structures: Array = [ +const data_structures: Array = [ { label: "JSON" }, { label: "TOML" }, { label: "XML" }, { label: "YAML" }, ]; -const frameworks: Array = [ +const frameworks: Array = [ { label: "Angular" }, { label: "Astro" }, { label: "Hono" }, @@ -20,7 +20,7 @@ const frameworks: Array = [ { label: "Web Crypto", variants: ["webcrypto"] }, ]; -const integrations: Array = [ +const integrations: Array = [ { label: "Azure", variants: ["Microsoft Azure", "MS Azure"] }, { label: "AWS", variants: ["Amazon Web Services"] }, { label: "GCP", variants: ["Google Cloud", "Google Cloud Platform"] }, @@ -39,7 +39,7 @@ const integrations: Array = [ { label: "WordPress" }, ]; -const languages: Array = [ +const languages: Array = [ { label: "Go" }, { label: "GraphQL" }, { label: "JavaScript", variants: ["js"] }, @@ -53,7 +53,7 @@ const languages: Array = [ { label: "WebAssembly", variants: ["Web Assembly", "wasm"] }, ]; -const protocols: Array = [ +const protocols: Array = [ { label: "FTP", variants: ["file transfer protocol"] }, { label: "IPsec" }, { label: "IPv4" }, @@ -73,13 +73,13 @@ const protocols: Array = [ { label: "Wireguard" }, ]; -const operating_systems: Array = [ +const operating_systems: Array = [ { label: "Linux" }, { label: "MacOS", variants: ["OS X"] }, { label: "Windows", variants: ["ms windows"] }, ]; -const use_cases: Array = [ +const use_cases: Array = [ { label: "Authentication", variants: ["auth"] }, { label: "A/B testing", variants: ["ab test"] }, { label: "Caching", variants: ["cache"] }, From a9981f994dc445c576047228f659d76ab7ab1310 Mon Sep 17 00:00:00 2001 From: kodster28 Date: Tue, 11 Mar 2025 15:51:48 -0500 Subject: [PATCH 06/11] shell --- src/schemas/tags.ts | 1 + 1 file changed, 1 insertion(+) diff --git a/src/schemas/tags.ts b/src/schemas/tags.ts index 5588563e213c63..906065c87c4492 100644 --- a/src/schemas/tags.ts +++ b/src/schemas/tags.ts @@ -48,6 +48,7 @@ const languages: Array = [ { label: "PowerShell", variants: ["js"] }, { label: "Python", variants: ["py"] }, { label: "Rust", variants: ["rs"] }, + { label: "Shell", variants: ["sh"] }, { label: "SQL" }, { label: "TypeScript", variants: ["ts"] }, { label: "WebAssembly", variants: ["Web Assembly", "wasm"] }, From ebeb200e585030252b87e52a70f19d0b8dd2635e Mon Sep 17 00:00:00 2001 From: kodster28 Date: Tue, 11 Mar 2025 15:58:35 -0500 Subject: [PATCH 07/11] Add comment to file --- src/schemas/tags.ts | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/src/schemas/tags.ts b/src/schemas/tags.ts index 906065c87c4492..5355b20dc9777e 100644 --- a/src/schemas/tags.ts +++ b/src/schemas/tags.ts @@ -1,3 +1,8 @@ +/* This is the allowlist for the tags we allow +in our page frontmatter. Refer to https://developers.cloudflare.com/style-guide/frontmatter/custom-properties/#tags +and https://developers.cloudflare.com/style-guide/frontmatter/tags/ for more details. +*/ + const data_structures: Array = [ { label: "JSON" }, { label: "TOML" }, From 9174a6a55d5a87d35aaa2bd805d5cc28a4cfd53c Mon Sep 17 00:00:00 2001 From: kodster28 Date: Tue, 11 Mar 2025 16:01:52 -0500 Subject: [PATCH 08/11] Mobile operating systems --- src/schemas/tags.ts | 2 ++ 1 file changed, 2 insertions(+) diff --git a/src/schemas/tags.ts b/src/schemas/tags.ts index 5355b20dc9777e..45e5b0f9edc1e1 100644 --- a/src/schemas/tags.ts +++ b/src/schemas/tags.ts @@ -80,6 +80,8 @@ const protocols: Array = [ ]; const operating_systems: Array = [ + { label: "Android" }, + { label: "iOS" }, { label: "Linux" }, { label: "MacOS", variants: ["OS X"] }, { label: "Windows", variants: ["ms windows"] }, From b5bce78ab53e6cb3500a2f6a35892a54351e9a63 Mon Sep 17 00:00:00 2001 From: kodster28 Date: Tue, 11 Mar 2025 16:03:29 -0500 Subject: [PATCH 09/11] Update codeowners --- .github/CODEOWNERS | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS index 7d9549e0fc4c74..43b7891ad26ee5 100644 --- a/.github/CODEOWNERS +++ b/.github/CODEOWNERS @@ -10,6 +10,7 @@ /.github/actions/assign-pr/index.js @cloudflare/pcx-technical-writing /.github/styles/cloudflare/spelling-exceptions.txt @cloudflare/pcx-technical-writing /src/components/ @cloudflare/developer-advocacy @kristianfreeman @kodster28 @pedrosousa @marciocloudflare @haleycode @maxvp @GregBrimble @KianNH @WalshyDev +/src/schemas/tags.ts @kodster28 @KianNH @joslyn-cf *.js @cloudflare/developer-advocacy @kristianfreeman @kodster28 @pedrosousa @haleycode @maxvp @marciocloudflare @GregBrimble @KianNH @WalshyDev *.ts @cloudflare/developer-advocacy @kristianfreeman @kodster28 @pedrosousa @haleycode @maxvp @marciocloudflare @GregBrimble @KianNH @WalshyDev /src/content/workers-ai-models/ @craigsdennis @pedrosousa @cloudflare/pcx-technical-writing From 71d25a5c79658b825aa8ce614375ca5489f696a0 Mon Sep 17 00:00:00 2001 From: kodster28 Date: Wed, 12 Mar 2025 08:16:26 -0500 Subject: [PATCH 10/11] Add a few more --- src/schemas/tags.ts | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/src/schemas/tags.ts b/src/schemas/tags.ts index 45e5b0f9edc1e1..27539a4e11d2f6 100644 --- a/src/schemas/tags.ts +++ b/src/schemas/tags.ts @@ -60,7 +60,7 @@ const languages: Array = [ ]; const protocols: Array = [ - { label: "FTP", variants: ["file transfer protocol"] }, + { label: "FTP", variants: ["file transfer protocol", "ftps"] }, { label: "IPsec" }, { label: "IPv4" }, { label: "IPv6" }, @@ -69,11 +69,14 @@ const protocols: Array = [ { label: "mTLS" }, { label: "NetFlow" }, { label: "MQTT" }, + { label: "QUIC" }, { label: "RDP" }, { label: "SAML" }, { label: "SCIM" }, { label: "SMTP" }, + { label: "SFTP" }, { label: "SSH" }, + { label: "TCP" }, { label: "UDP" }, { label: "WebSockets", variants: ["websocket"] }, { label: "Wireguard" }, @@ -94,7 +97,7 @@ const use_cases: Array = [ { label: "CMS" }, { label: "Cookies" }, { label: "CORS" }, - { label: "Debugging", variants: ["debug"] }, + { label: "Debugging", variants: ["debug", "troubleshooting"] }, { label: "Forms" }, { label: "Geolocation" }, { label: "HTMLRewriter" }, @@ -103,6 +106,7 @@ const use_cases: Array = [ { label: "Logging" }, { label: "Middleware" }, { label: "Playback" }, + { label: "Privacy" }, { label: "Redirects", variants: ["redirect"] }, { label: "Request modification", variants: ["request"] }, { label: "Response modification", variants: ["response"] }, From d2af0854a5a040031d7116a827a9fb39e5179973 Mon Sep 17 00:00:00 2001 From: kodster28 Date: Wed, 12 Mar 2025 08:31:39 -0500 Subject: [PATCH 11/11] Move rpc --- src/schemas/tags.ts | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/src/schemas/tags.ts b/src/schemas/tags.ts index 27539a4e11d2f6..a5b6824422e6c9 100644 --- a/src/schemas/tags.ts +++ b/src/schemas/tags.ts @@ -17,12 +17,10 @@ const frameworks: Array = [ { label: "Next.js", variants: ["nextjs"] }, { label: "Node.js", variants: ["node", "nodejs"] }, { label: "Nuxt" }, - { label: "RPC" }, { label: "Ruby", variants: ["rb", "ruby on rails"] }, { label: "Svelte" }, { label: "SvelteKit" }, { label: "Vue.js", variants: ["vue", "vuejs"] }, - { label: "Web Crypto", variants: ["webcrypto"] }, ]; const integrations: Array = [ @@ -110,6 +108,7 @@ const use_cases: Array = [ { label: "Redirects", variants: ["redirect"] }, { label: "Request modification", variants: ["request"] }, { label: "Response modification", variants: ["response"] }, + { label: "RPC" }, { label: "Security" }, { label: "URL rewrite", variants: ["rewrite"] }, ];