mirror of
https://github.com/docker/docs.git
synced 2026-06-19 07:35:16 +00:00
David Karlsson
44e75340dc
The above/below substitutions fired on idioms ("above and beyond"),
numeric comparisons ("above the 90th percentile"), and version
references ("macOS Ventura and above"), where "previous"/"following"
makes no sense. Drop them — the canonical "see the example above"
case is mild enough that human review can catch it.
Extend TokenIgnores so shortcodes followed by path segments
(``{{% param "x" %}}/dists/``) and shortcodes nested inside markdown
link text are both treated as opaque. Fixes spurious URL/term hits
across the engine/install pages.
Add vocab entries for legitimate technical terms previously flagged by
Vale.Spelling (bootloader, crypto, Kubuntu/Lubuntu/Xubuntu, lockfile,
multimodal, multithreading, NLP, oldoldstable, parallelizable, pnpm,
superset, tokenization, WebGL). Also wrap the `println` heading in
formatting.md in backticks — it's a Go template function, not prose.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
40 lines
987 B
YAML
40 lines
987 B
YAML
extends: substitution
|
|
message: "Consider using '%s' instead of '%s'"
|
|
link: https://docs.docker.com/contribute/style/recommended-words/
|
|
ignorecase: true
|
|
level: suggestion
|
|
action:
|
|
name: replace
|
|
swap:
|
|
'\b(?:eg|e\.g\.)[\s,]': for example
|
|
'\b(?:ie|i\.e\.)[\s,]': that is
|
|
(?:account name|accountname|user name): username
|
|
(?:drop down|dropdown): drop-down
|
|
\blog out\b: sign out
|
|
\b(?:sign on|log on|log in)\b: sign in
|
|
adaptor: adapter
|
|
administrate: administer
|
|
afterwards: afterward
|
|
allows: lets
|
|
alphabetic: alphabetical
|
|
alphanumerical: alphanumeric
|
|
anti-aliasing: antialiasing
|
|
anti-malware: antimalware
|
|
anti-spyware: antispyware
|
|
anti-virus: antivirus
|
|
appendixes: appendices
|
|
assembler: assembly
|
|
check box: checkbox
|
|
check boxes: checkboxes
|
|
click: select
|
|
distro: distribution
|
|
ergo: therefore
|
|
file name: filename
|
|
keypress: keystroke
|
|
mutices: mutexes
|
|
repo: repository
|
|
scroll: navigate
|
|
url: URL
|
|
'\bvs\b(?!\.|\s+Code)': versus
|
|
wish: want
|