From d44eaf4b79e3da9714cc272bfd40edf4b0cd11b2 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Fri, 19 Sep 2025 15:51:54 -0700 Subject: [PATCH 1/5] update header exceptions --- .vale/styles/Google/Headings.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.vale/styles/Google/Headings.yml b/.vale/styles/Google/Headings.yml index 756f95209..adf8ec4ef 100644 --- a/.vale/styles/Google/Headings.yml +++ b/.vale/styles/Google/Headings.yml @@ -7,13 +7,13 @@ match: $sentence exceptions: - API - APIs - - APP - CDN - CORS - CLI - CSS - DNS - GitHub + - GitHub App - GitLab - HTML - JavaScript From a569157dce352bad3e0d1600e2aaa67a7d9fcf27 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Fri, 19 Sep 2025 15:52:28 -0700 Subject: [PATCH 2/5] remove FirstPerson rule it mostly flags UI elements like "My profile" --- .vale/styles/Google/FirstPerson.yml | 13 ------------- 1 file changed, 13 deletions(-) delete mode 100644 .vale/styles/Google/FirstPerson.yml diff --git a/.vale/styles/Google/FirstPerson.yml b/.vale/styles/Google/FirstPerson.yml deleted file mode 100644 index 0b7b8828c..000000000 --- a/.vale/styles/Google/FirstPerson.yml +++ /dev/null @@ -1,13 +0,0 @@ -extends: existence -message: "Avoid first-person pronouns such as '%s'." -link: 'https://developers.google.com/style/pronouns#personal-pronouns' -ignorecase: true -level: warning -nonword: true -tokens: - - (?:^|\s)I\s - - (?:^|\s)I,\s - - \bI'm\b - - \bme\b - - \bmy\b - - \bmine\b From 1ee16a0a7027f95ac87f9e199c6395bebde2c946 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Fri, 19 Sep 2025 16:08:06 -0700 Subject: [PATCH 3/5] remove Will - too noisy --- .vale/styles/Google/Will.yml | 7 ------- 1 file changed, 7 deletions(-) delete mode 100644 .vale/styles/Google/Will.yml diff --git a/.vale/styles/Google/Will.yml b/.vale/styles/Google/Will.yml deleted file mode 100644 index 128a91836..000000000 --- a/.vale/styles/Google/Will.yml +++ /dev/null @@ -1,7 +0,0 @@ -extends: existence -message: "Avoid using '%s'." -link: 'https://developers.google.com/style/tense' -ignorecase: true -level: warning -tokens: - - will From 307ef5c40d455ae6f2e1e37a8503f5c30811c654 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Fri, 19 Sep 2025 16:10:50 -0700 Subject: [PATCH 4/5] add drilldown to accept list --- .vale/styles/config/vocabularies/Mintlify/accept.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/.vale/styles/config/vocabularies/Mintlify/accept.txt b/.vale/styles/config/vocabularies/Mintlify/accept.txt index 647318c6b..dacd128cf 100644 --- a/.vale/styles/config/vocabularies/Mintlify/accept.txt +++ b/.vale/styles/config/vocabularies/Mintlify/accept.txt @@ -11,6 +11,7 @@ discoverability callout Callouts callouts +drilldown expandables favicon isHidden From 9f3fd0d4fca58c5f3a2f659fa732f242527482c3 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Fri, 19 Sep 2025 16:14:10 -0700 Subject: [PATCH 5/5] update accepted words --- .vale/styles/Google/Headings.yml | 3 +++ .vale/styles/config/vocabularies/Mintlify/accept.txt | 7 ++++++- 2 files changed, 9 insertions(+), 1 deletion(-) diff --git a/.vale/styles/Google/Headings.yml b/.vale/styles/Google/Headings.yml index adf8ec4ef..6e2645923 100644 --- a/.vale/styles/Google/Headings.yml +++ b/.vale/styles/Google/Headings.yml @@ -10,6 +10,8 @@ exceptions: - CDN - CORS - CLI + - Cloudflare + - Cloudflare Worker - CSS - DNS - GitHub @@ -36,4 +38,5 @@ exceptions: - UX - URL - URLs + - Vercel - Windows diff --git a/.vale/styles/config/vocabularies/Mintlify/accept.txt b/.vale/styles/config/vocabularies/Mintlify/accept.txt index dacd128cf..d842eda5d 100644 --- a/.vale/styles/config/vocabularies/Mintlify/accept.txt +++ b/.vale/styles/config/vocabularies/Mintlify/accept.txt @@ -93,26 +93,31 @@ RubyGems Rust Spring Storybook +subpath Swift TensorFlow Terraform TypeDoc TypeScript Unix +Vercel +vercel Vite vite Visual Studio Code VS Code Vue Vuex +Webflow +WebKit Webpack webpack -WebKit WebStorm # ============================================================================= # TERMS # ============================================================================= +allowlist APIs args async