Improve Vale rules based on rhel-8-docs analysis

.claude/settings.local.json

@@ -0,0 +1,9 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(cat:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

.gitignore

@@ -3,6 +3,7 @@
 .DS_Store
 .vale/styles/RedHat.zip
 .vscode/settings.json
+tmp/
 /*.gem
 /*.html
 /.bundle

.vale/fixtures/AsciiDoc/UnsetAttributes/testinvalid.adoc

@@ -17,4 +17,3 @@ Ignore multi-line comments
 //ignore comments
 //:!infra:
 
-:!infra:

.vale/fixtures/RedHat/CaseSensitiveTerms/testinvalid.adoc

@@ -252,7 +252,6 @@ Kie Server
 kjar
 kJAR
 knowledge API
-knowledge base
 knowledge session
 knowledgebase
 ksession
@@ -498,7 +497,6 @@ UltraSparc
 ULTRASPARC
 unix
 Unix
-UNIX-like
 uri
 url
 urn

.vale/fixtures/RedHat/TermsErrors/testinvalid.adoc

@@ -405,7 +405,6 @@ switch off
 synch
 sysprep function
 system engineer
-tablespace
 TCP/IP network
 teleprocessing line
 testcase

.vale/styles/RedHat/CaseSensitiveTerms.yml

@@ -21,7 +21,7 @@ swap:
   "[dD]ay-1|day 1": Day 1
   "[dD]ay-2|day 2": Day 2
   "BPMS|(?<!Red Hat )JBoss BPMS|(?<!Red Hat JBoss )BPM(?! Suite)": Red Hat JBoss BPM Suite
-  "DM(?![ -]Multipath)|directory manager": Directory Manager
+  "DM(?![ -]?[Mm]ultipath)|directory manager": Directory Manager
   "JBoss Broker|Red Hat Broker|The AMQ Broker": AMQ Broker
   "JBoss Console|Red Hat Console": AMQ Console
   "Kernel(?!-based Virtual Machine| Module Management| parameters| arguments| packet filtering)": kernel
@@ -170,7 +170,7 @@ swap:
   jetbrains|Jetbrains: JetBrains
   Junit|junit: JUnit
   Jvm|jvm: JVM
-  kbase|knowledge base: KIE base
+  kbase: KIE base
   kernel-based virtual machine: Kernel-based Virtual Machine
   kernelspace: kernel space
   key store: keystore
@@ -302,7 +302,7 @@ swap:
   ttl: TTL
   uid: UID
   ULTRASPARC|UltraSparc: UltraSPARC
-  Unix|unix|UNIX-like: UNIX
+  Unix|unix: UNIX
   uri: URI
   url: URL
   urn: URN

.vale/styles/RedHat/ConsciousLanguage.yml

@@ -8,6 +8,6 @@ action:
   name: replace
 swap:
   blacklist: blocklist
-  master(?! broker): primary|source|initiator|requester|controller|host|director|supplier
+  master(?! broker| boot record): primary|source|initiator|requester|controller|host|director|supplier
   slave(?! broker): secondary|replica|responder|device|worker|proxy|performer|consumer|child
   whitelist: allowlist

.vale/styles/RedHat/Definitions.yml

@@ -21,6 +21,7 @@ exceptions:
   - 'PIDs?'
   - 'ROMs?'
   - 'RPMs?'
+  - 'SRPMs?'
   - 'UIDs?'
   - 'URIs?'
   - 'URLs?'
@@ -84,6 +85,7 @@ exceptions:
   - IAM
   - IBM
   - IDE
+  - IEEE
   - IOPS
   - IOV
   - IP
@@ -99,6 +101,7 @@ exceptions:
   - KVM
   - LAN
   - LDAP
+  - LDIF
   - LESS
   - LGAI
   - LLDB
@@ -121,6 +124,7 @@ exceptions:
   - NOTE
   - NTP
   - NVDA
+  - OCI
   - OEM
   - OSS
   - OVN

.vale/styles/RedHat/DoNotUseTerms.yml

@@ -7,7 +7,7 @@ message: "%s"
 swap:
   # Start each error message with "Do not use ..."
   # Error messages must be single quoted.
-  'ACK(?! flag)': 'Do not use "ACK" as acronym for "acknowledgement". When writing about the acknowledgement flag ("ACK flag") in a TCP packet, use "ACK flag".'
+  'ACK(?! flag| packet)': 'Do not use "ACK" as acronym for "acknowledgement". When writing about the acknowledgement flag ("ACK flag") or acknowledgement packet ("ACK packet") in a TCP packet, use "ACK flag" or "ACK packet".'
   'future-proof': Do not use "future-proof" in a statement about the benefits, characteristics, or performance of a Red Hat product or service.'
   'out of the box|out-of-the-box': 'Do not use "out of the box" or "out-of-the-box". Use text that is suitable for the context and the noun to which this adjective applies.'
   and/or: 'Do not use "and/or". Depending on the context, use one of the following constructions: a and b, a or b, or a, b, or both.'

.vale/styles/RedHat/GitLinks.yml

@@ -8,5 +8,5 @@ scope: raw
 action:
   name: remove
 tokens:
-  - 'https:\/\/gitlab\.com\/\w+'
-  - 'https:\/\/github\.com(?!\/openshift|\/redhat-developer)'
+  - 'https:\/\/gitlab\.com(?!\/redhat)\/\w+'
+  - 'https:\/\/github\.com(?!\/openshift|\/redhat-developer|\/redhat-documentation)'

.vale/styles/RedHat/ObviousTerms.yml

@@ -13,4 +13,4 @@ tokens:
   - 'Password field'
   - 'Mail field'
   - 'Description field'
-  - 'Name field'
+  - 'Name field'

.vale/styles/RedHat/PascalCamelCase.yml

@@ -18,6 +18,7 @@ exceptions:
   - 'vCPUs?'
   - 3scale
   - AGPLv
+  - AirPrint
   - AMQ
   - API
   - AppStream
@@ -40,13 +41,16 @@ exceptions:
   - ConnectX
   - Convert2RHEL
   - CoreOS
+  - CPUfreq
   - DaemonSet
   - DDoS
   - DeepSeek
   - DevOps
   - DevWorkspace
   - DialoGPT
   - DNSSec
+  - DoS
+  - DoT
   - EleutherAI
   - eServer
   - eXpress
@@ -56,6 +60,8 @@ exceptions:
   - FFmpeg
   - FileStore
   - FireWire
+  - FreeIPA
+  - FreeOTP
   - FreeRADIUS
   - GbE
   - GBps
@@ -78,6 +84,7 @@ exceptions:
   - IBoE
   - IconBurst
   - IdM
+  - IdPs?
   - IKEv
   - InfiniBand
   - InnoDB
@@ -104,26 +111,31 @@ exceptions:
   - LinuxONE
   - LiquidIO
   - LLaDA
+  - MACSec
   - ManageIQ
   - MariaDB
   - MaziyarPanahi
   - MBps
   - MegaRAID
   - MiB
   - MicroProfile
+  - ModSecurity
   - MoE
   - MongoDB
   - MoreUtils
   - MySQL
   - NetBIOS
   - NetcoredebugOutput
   - NetWeaver
+  - NetKVM
   - NetworkManager
   - NetXen
   - NetXtreme
   - NFSv
   - NMState
+  - NoCloud
   - NousResearch
+  - NTAuth
   - NuGet
   - NVMe
   - OAuth
@@ -148,6 +160,7 @@ exceptions:
   - OperatorHub
   - OpEx
   - OSBuild
+  - OSTree
   - OTel
   - PaaS
   - PackageKit
@@ -158,6 +171,7 @@ exceptions:
   - PostScript
   - PowerPC
   - PowerShell
+  - PowerTOP
   - ProLiant
   - PulseAudio
   - PyPA
@@ -169,6 +183,7 @@ exceptions:
   - RESTEasy
   - RHEL
   - RoCE
+  - RubyGems
   - SaaS
   - SeaBIOS
   - SELinux
@@ -181,6 +196,7 @@ exceptions:
   - STMicroelectronics
   - SuperLU
   - SysV
+  - SystemTap
   - TBps
   - TheBloke
   - TiB
@@ -191,13 +207,15 @@ exceptions:
   - USBGuard
   - vCenter
   - vDisk
+  - vGPUs?
   - vHost
   - VMware
   - vSphere
   - vSwitch
   - vLLM
   - WebAuthn
   - WebSocket
+  - WebUI
   - WireGuard
   - XEmacs
   - xPaaS

.vale/styles/RedHat/Slash.yml

@@ -15,19 +15,33 @@ exceptions:
   - 'https?://\S+'
   # common technical terms
   - "0/"
+  - "[Aa]ccess/InfiniBand"
+  - "[Aa]ctive/[Aa]ctive"
+  - "[Aa]ctive/[Pp]assive"
+  - "[Cc]heckpoint/[Rr]estore"
   - "[Ii]nput/[Oo]utput"
   - "[Kk]ey/value"
+  - "[Mm]in/[Mm]ax"
+  - "[Pp]acemaker/[Cc]orosync"
+  - "[Ss]ource/[Dd]estination"
+  - "[Ss]top/[Ss]tart"
   - "C/C"
   - "CI/CD"
   - "client/server"
   - "I/O"
   - "N/A"
+  - "NVMe/FC"
+  - "NVMe/RDMA"
+  - "NVMe/TCP"
   - "read/write"
+  - "S/MIME"
   - "SSL/TLS"
+  - "Tcl/T[Kk]"
   - "TCP/IP"
   - "upstream/downstream"
   - "z/OS"
   - "z/OSMF"
+  - "z/VM"
   - '.*ai/\w+'
   - '.*AI/\w+'
   - '.*community/\w+'

.vale/styles/RedHat/TermsErrors.yml

@@ -8,7 +8,7 @@ action:
   name: replace
 # swap maps tokens in form of bad: good
 swap:
-  "(?<!-)healthcheck|health-check": health check
+  "(?<!IdM |-)healthcheck|health-check": health check
   "(?<!-)pm": PM
   "(?<!-|.|{)env": environment
   "(?<!-|I )am": AM
@@ -85,7 +85,7 @@ swap:
   blink: flash
   blue screen of death: stop error
   boot diskette: boot disk
-  bootloader: boot loader
+  "(?<!Grand Unified |GRUB )bootloader": boot loader
   breadcrumbing: breadcrumb trail
   break point: breakpoint
   bring up: start|power on|open|turn on
@@ -390,7 +390,6 @@ swap:
   syncpoint: sync point
   sysprep tool|sysprep process|sysprep function: sysprep
   system engineer: systems engineer
-  tablespace: table space
   TCP/IP network: Internet Protocol network|IP network
   teleprocessing line: telecommunication line|transmission line
   testcase: test case

.vale/styles/RedHat/TermsSuggestions.yml

@@ -14,7 +14,7 @@ swap:
   "[Nn]avigate": click|select|browse|go to
   "bottom(?:-)?left": lower left|lower-left
   "bottom(?:-)?right": lower right|lower-right
-  "shell(?! prompt| script)": shell prompt
+  "shell(?! prompt| script| command)": shell prompt
   "x64|x86-64|(?<!64-bit )x86": 64-bit x86|x86_64
   '(?<!-|\.)\bk8s\b(?!-|\.)': Kubernetes
   '(?<!.*-|program )operator': Operator
@@ -35,14 +35,14 @@ swap:
   consumes: uses
   distro: distribution
   drag and drop: drag
-  executable(?! program| routine| files?): executable program
+  executable(?! program| routine| files?| code): executable program
   frontend: front end|front-end
-  higher: later
+  higher(?! CPU| latency| level| priority| performance| usage| throughput| bandwidth): later
   hit: press|type
   in order to: to
   information on: information about
   launch: start|open
-  legacy: existing|traditional|established|classic|earlier|previous
+  legacy(?! mode| system): existing|traditional|established|classic|earlier|previous
   on-premise: on-site|in-house
   once: after|when
   refer to: see

.vale/styles/RedHat/Using.yml

@@ -3,6 +3,7 @@ extends: sequence
 message: "Use 'by using' instead of 'using' when it follows a noun for clarity and grammatical correctness."
 link: https://redhat-documentation.github.io/vale-at-red-hat/reference-guide.html#using
 level: warning
+scope: ~heading
 action:
   name: edit
   params: