Repository navigation
feat: enable Coder.LGBTQ Vale rule - #31181
Merged
Merged
Conversation
coder
Bot
force-pushed
the
superblink/docs-431-add-coderlgbtq-vale-rule
branch
from
October 23, 2026 08:36
7b51911 to
4ba5e2c
Compare
coder
Bot
changed the base branch from
main
to
superblink/docs-430-add-coderacronymperiods-vale-rule
October 23, 2026 08:36
This was referenced Oct 23, 2026
nickvigilante
approved these changes
Oct 23, 2026
Base automatically changed from
superblink/docs-430-add-coderacronymperiods-vale-rule
to
main
October 23, 2026 15:56
nickvigilante
added a commit
that referenced
this pull request
Oct 23, 2026
> [!NOTE] > Recreated from #30783 under coder[bot] by Superblink, at the request of @nickvigilante, so he can review and merge it. An AI agent wrote the original, which was opened from his account. The diff is identical to #30783, squashed onto current `main`. Superblink reviewed it and ran Vale over `docs/` before opening this PR (no new warnings or errors). #30783 should be closed in favor of this one. > Stack: this is the bottom of a 6-PR stack (#31180 → #31181 → #31182 → #31183 → #31184 → #31185). Merge them in that order. Depends on #30782. Adds `Coder.AcronymPeriods`, a Vale rule that enforces [No periods in acronyms](https://github.com/coder/coder/blob/main/docs/.style/style-guide/capitalization-and-punctuation.md#no-periods-in-acronyms). It flags capitalized acronyms written with periods, such as `A.P.I.` or `U.S.`. - Severity: `warning`. - Scope: `docs/**` except `docs/.style/style-guide/**`, with no other exclusions. - Baseline: 0 findings, including the generated `docs/reference/{api,cli,agent-api}` pages, so no cleanup commit. - The PR flips the guide footer to enforced, adds the checks-table row, and updates the coverage counts (10 tool-checked, 32 planned) and the tooling paragraph (10 of 87). - Known limitation: a version placeholder such as X.Y.Z in plain prose matches as "X.Y.". None exist outside code font today, and the guide asks for code font on placeholders, which Vale skips. Linear: DOCS-430 <details><summary>Decision log</summary> - Pattern `\b(?:[A-Z]\.){2,}`. Google.Periods used `{3,}`, but `U.S.` is a two-letter case the guide's Don't example names, so the rule requires two or more pairs. - Google rules aren't loaded, so nothing needed turning off. - `e.g.` and `i.e.` can't match: the rule is case-sensitive and accepts capital letters only. A single initial such as `J. Smith` can't match either. - Existence rule, `nonword: true`, `ignorecase: false`, same shape as `UnitSpacing`. - Test fixtures (not committed) with both LF and CRLF endings: - Flags: `A.P.I.`, `U.S.`, `E.U.`, and `X.Y.Z` in prose (reported as `X.Y.`). - Doesn't flag: `API`, `US`, `e.g.`, `i.e.`, `etc.`, `J. Smith`, `a.m.`, `p.m.`, code spans, fenced code. - LF and CRLF reported identical findings. - Checks: `vale docs/` reports 0 `Coder.AcronymPeriods` findings, `go run ./scripts/styleclaims` passes, and the pre-commit-light hook (markdownlint, emdash, style-claims) passes. </details> *Generated by [Coder Agents](https://coder.com/docs/ai-coder/agents) on behalf of @nickvigilante.* Created on behalf of @nickvigilante Co-authored-by: Nick Vigilante <nick.vigilante@coder.com>
nickvigilante
force-pushed
the
superblink/docs-431-add-coderlgbtq-vale-rule
branch
from
October 23, 2026 16:01
4ba5e2c to
7b1aa58
Compare
nickvigilante
enabled auto-merge (squash)
October 23, 2026 16:01
nickvigilante
deleted the
superblink/docs-431-add-coderlgbtq-vale-rule
branch
October 23, 2026 16:08
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Note
Recreated from #30786 under coder[bot] by Superblink, at the request of @nickvigilante, so he can review and merge it. An AI agent wrote the original, which was opened from his account. The diff is identical to #30786, squashed onto current
main. Superblink reviewed it and ran Vale overdocs/before opening this PR (no new warnings or errors). #30786 should be closed in favor of this one.Stack: based on #31180 (#31180 → #31181 → #31182 → #31183 → #31184 → #31185). The diff matches #30786 except for the counters in
docs/.style/style-guide/README.md, which build on the PRs below this one.make lint/style-claimspasses at every level.Depends on #30782.
Adds
Coder.LGBTQ, a Vale substitution rule that enforces Inclusive LGBTQ terms.It flags outdated terms for sex, gender, and sexual orientation, and suggests the current term.
warning.docs/**exceptdocs/.style/style-guide/**, with no other exclusions.LGBTQ.ymllist.alex is MIT licensed (Copyright (c) 2020 errata.ai), and the YAML header carries the attribution and a list of changes.
Linear: DOCS-431
Decision log
errata-ai/alexalex/LGBTQ.yml, MIT license./tmpdraft matched upstream.bi, because it flags "Power BI".special rights, because permissions docs could use it as a plain technical phrase.homo, because it flags "Homo sapiens".a transgenderfrom the guide table.It matches only when followed by
is,was,who,and,or,but,that,has,had,can,will,would, orshould, soa transgender personanda transgender womanstay clean.A noun use followed by punctuation (
Ask a transgender.) isn't caught.preferred pronouns,transgendered,gender pronouns,biologically female,born a man,genetically male, andhermaphroditecome from upstream.homosexualis flagged in any use, as upstream does, which is stricter than the guide's "as a noun".|separator in suggestions became ", ", the form the other Coder substitution rules use.homosexualcompounds,sexual preference,sex change,bathroom bill,transgenders.Power BI,bi-directional,bi-weekly,homogeneous,special rights, the guide's Do terms,a transgender person,a transgender woman, and terms inside code spans and fences.vale docs/reports 0Coder.LGBTQfindings,go run ./scripts/styleclaimspasses, and the pre-commit-light hook passes.Generated by Coder Agents on behalf of @nickvigilante.
Created on behalf of @nickvigilante