Skip to content

Replace 'whitelist' with inclusive 'allowlist' terminology#3737

Merged
ethanpalm merged 1 commit intomainfrom
vale-style-audit-1771969163
Feb 27, 2026
Merged

Replace 'whitelist' with inclusive 'allowlist' terminology#3737
ethanpalm merged 1 commit intomainfrom
vale-style-audit-1771969163

Conversation

@mintlify-development
Copy link
Contributor

@mintlify-development mintlify-development bot commented Feb 24, 2026

Summary

  • Replaced "whitelist" with "allowlist" across 4 documentation files for inclusive language

Vale style audit results

The codebase is well-maintained with minimal Vale style rule violations. The automated fixes address the only clear auto-fixable issue found.

Items requiring human judgment

The following items were flagged but require manual review as fixes may alter meaning:

WordList warnings (Mintlify.WordList)

File Line Issue Suggestion
deploy/ghes.mdx 234 "functionality" Consider "capability" or "feature"
deploy/route53-cloudfront.mdx 177 "functionality" Consider "capability" or "feature"
guides/content-templates.mdx 179 "functionality" Consider "feature"
guides/content-types.mdx 62 "functionality" Consider "feature"
guides/cursor.mdx 374 "functionality" Consider "capability" or "feature"
guides/linking.mdx 125 "functionality" Consider "capability" or "feature"

Will usage warnings (Mintlify.Will)

These use future tense ("will") where present tense may be preferred:

  • deploy/ghes.mdx:233 - "The app will need to be re-approved"
  • guides/assistant-embed.mdx:8 - "What you will build"
  • guides/automate-agent.mdx:8 - "What you will build"
  • guides/understand-your-audience.mdx:42 - "There will always be edge cases"
  • guides/windsurf.mdx:16 - "they will not be consistent"
  • installation.mdx:275 - "You will be prompted"

Notes

  • Exclamation points in components/banner.mdx, organize/navigation.mdx, and organize/settings.mdx are in JSON example content demonstrating banner announcements - these are appropriate for examples
  • First-person pronouns found are in keyboard shortcut labels (I key) or code examples
  • No errors found for: AMPM, DateFormat, EmDash, Latin abbreviations, LyHyphens, OptionalPlurals, Ordinal, Periods, Quotes, Slang, Spacing, or Units rules

Note

Low Risk
Documentation-only terminology updates with no functional or configuration changes; low risk aside from minor wording clarity.

Overview
Updates docs terminology to use inclusive language by replacing “whitelist” with “allowlist” in CSP guidance, GHES firewall instructions, CLI installation troubleshooting, and the Osano integration troubleshooting section.

Written by Cursor Bugbot for commit b726a51. This will update automatically on new commits. Configure here.

@ethanpalm ethanpalm merged commit 00984f6 into main Feb 27, 2026
5 checks passed
@ethanpalm ethanpalm deleted the vale-style-audit-1771969163 branch February 27, 2026 19:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant