1
0
Fork 0
forked from docs/team-docs

ci: fix vale pipeline

This commit is contained in:
darknao 2023-06-24 21:05:10 +02:00
commit 31d1f24ebb
No known key found for this signature in database
33 changed files with 68 additions and 2436 deletions

2
.gitignore vendored
View file

@ -1,3 +1,5 @@
.vale
gl-code-quality-report.json
build
cache
public

View file

@ -36,12 +36,16 @@ code_quality:
VARH_REPO: "redhat-documentation/vale-at-red-hat"
VARH_BRANCH: "main"
before_script:
- apk add --no-cache curl asciidoctor python3
- |
curl -o vale2cc.py \
https://raw.githubusercontent.com/${VARH_REPO}/${VARH_BRANCH}/tools/vale2cc.py
# - apk update && apk add git
- vale sync
script:
- vale --no-exit --output=JSON . | python3 vale2cc.py > gl-code-quality-report.json
# list of updated/modified *.adoc files
# - FILES=$(git diff --name-only HEAD~1 HEAD --diff-filter=d "*.adoc")
# clean out conditions for wider vale coverage
# - sed -i -e 's/ifdef::.*\|ifndef::.*\|ifeval::.*\|endif::.*/ /' ${FILES}
# use a template to rearrange the vale JSON output
# run vale with `--no-exit` to pass the build with errors
- vale --no-exit --minAlertLevel=error --glob='*.adoc' --output="$(pwd)/vale-json.tmpl" . | sed "s/CI_COMMIT_SHA/$CI_COMMIT_SHA/g" > gl-code-quality-report.json
artifacts:
reports:
codequality: gl-code-quality-report.json

View file

@ -1,9 +0,0 @@
---
extends: existence
level: error
link: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/abbreviations/
message: "Do not use periods in all-uppercase abbreviations such as '%s'."
nonword: true
# source: "IBM - Periods with abbreviations, p. 5"
tokens:
- '\b(?:[A-Z]\.){3,5}'

View file

@ -1,299 +0,0 @@
---
extends: substitution
ignorecase: false
level: error
link: https://redhat-documentation.github.io/vale-at-red-hat/docs/reference-guide/casesensitiveterms/
message: Use '%s' rather than '%s'.
# source: "https://redhat-documentation.github.io/supplementary-style-guide/#glossary-terms-conventions"
action:
name: replace
swap:
"(?<!/)var": VAR
# Bind: BIND
'(?<!\.)yaml|Yaml': YAML
'(?<!Business )Resource Planner|(?<!Business Resource )Planner': Business Resource Planner
'(?<!JBoss )EAP|(?<!Red Hat )JBoss(?!\sCommunity|\sBroker|\sClients|\sConsole|\sAMQ|\sData\sGrid|\sBRMS|\sBPMS|\sEnterprise\sApplication\sPlatform|\.org|\sInterconnect|\sEAP|\sBPM\sSuite)': JBoss EAP
'(?<!Microsoft )Azure': Microsoft Azure
'(?<!Microsoft Azure )On-Demand Marketplace': Microsoft Azure On-Demand Marketplace
'(?<!Realtime )Decision\sServer': Realtime Decision Server
'(?<!Red Hat )Customer Portal': Red Hat Customer Portal
'(?<!Red Hat )JBoss Enterprise Application Platform': Red Hat JBoss Enterprise Application Platform
'(?<!Red Hat )OpenStack Platform|RHOS|RH-OSP': Red Hat OpenStack Platform
'(?<!Red Hat JBoss )BRMS(?! engine)': inference engine
'(?<!Red Hat JBoss )BRMS|BRM|(?<!Red Hat )JBoss BRMS': Red Hat JBoss BRMS
'[nN]odejs|[nN]ode\.JS|node\.js': Node.js
'\s\.Net Core|\s\.Net|\s\.NET\sCore|dotNet': .NET
'A-MQ(?!\sBroker|\sClient|\sConsole|\sInterconnect)': AMQ
'A-MQ\sBroker': AMQ Broker
'A-MQ\sClients': AMQ Clients
'A-MQ\sConsole': AMQ Console
'A-MQ\sInterconnect': AMQ Interconnect
'ack\spacket|ACK(?!\sflag)|ack': ACK flag
'ActiveMQ\sArtemis|ActiveMQ(?!\sArtemis)': built-in messaging|JBoss EAP built-in messaging|JBoss EAP messaging
'Admin\sPortal|webadmin\sportal|webadmin|Administrator\sPortal|Administration\sportal': Administration Portal
'BPMS|(?<!Red Hat )JBoss BPMS|(?<!Red Hat JBoss )BPM(?! Suite)': Red Hat JBoss BPM Suite
'BRMS\sengine': inference engine
'DM(?![ -]Multipath)|directory manager': Directory Manager
'GUI\seditor|Business\sCentral\seditor': guided editor
'JBoss Broker|Red Hat Broker|The AMQ Broker': AMQ Broker
'JBoss Console|Red Hat Console': AMQ Console
'JBoss\.org': JBoss Community
'JBoss\sAMQ': AMQ
'JBoss\sInterconnect': AMQ Interconnect
'Kernel(?!-based Virtual Machine)': kernel
'Kie(?!\sServer)': KIE
'Kie\sServer': Intelligent Process Server
'O\.K\.D|okd|OpenShift Kubernetes Distribution|OpenShift\sOrigin': OKD
'OCM|(?<!Red Hat OpenShift )Cluster Manager|(?<!Red Hat )OpenShift Cluster Manager|the OpenShift Cluster Manager': Red Hat OpenShift Cluster Manager
'OD': Red Hat OpenShift Dedicated
'Red\sHat\sInterconnect': AMQ Interconnect
'Red\sHat\sVirtualization\sHypervisor|RHV\sHost|RHV-H': Red Hat Virtualization Host
'RHVM|RHV-M|RHV\sManager': Red Hat Virtualization Manager
'self-hosted\sengine\svirtual\smachine|engine\sVM': Manager virtual machine
Appliance Console: Appliance console
Applix|ApplixWare: Applixware
asciidoctor|AsciiDoctor: Asciidoctor
asciidoc|Asciidoc: AsciiDoc
assertj|Assertj: AssertJ
auto-link|AutoLink: autolink
basic authentication|Basic Authentication|basic auth|Basic auth|Basic Auth: Basic HTTP authentication (first instance)|Basic authentication
BC: Business Central
Bios: BIOS
blue print|BluePrint: blueprint
bluestore|Blue Store: BlueStore
btrfs: Btrfs
Capex|capex|capEx: CapEx
Capsule server: Capsule Server
CD 1: CD #1
CDS|Cds: CDs
Ceph Ansible: ceph-ansible
Ceph block device|Ceph block devices: Ceph Block Device
Ceph filesystem|Ceph file system: Ceph File System
Ceph monitor: Ceph Monitor
Ceph object gateway|Ceph object gateways: Ceph Object Gateway
ceph-osd|Object Storage Device|OSD daemon: OSD
cephfs: CephFS
CGroup|c group: cgroup
cidr|Classless Interdomain Routing|Classless Inter-domain Routing: CIDR
classic mode: GNOME Classic
CloudForms Management Engine|CFME: Red Hat CloudForms|Red Hat CloudForms Appliance
command prompt: shell prompt|Command Prompt (Windows product)
Composite Content view|composite content view|Composite View|composite view: Composite Content View
configmap: config map
configuration map: config map
Content view|content view: Content View
control key|ctrl: Ctrl
crush map|crushmap: CRUSH map
csv: CSV
CygMon|cygmon|CYGMON: Cygmon
Data Grid Administration Console: Data Grid Console
Data Grid console: Data Grid Console
Denial of Service: denial of service
Denial-of-Service: denial-of-service
Development Preview|Developer preview|dev preview: Developer Preview
devops|Devops|Dev-Ops|Dev Ops: DevOps
directory server: Directory Server
Disk druid|disk druid|diskdruid: Disk Druid
dns: DNS
DVD burner|burner: DVD writer
DWH|data warehouse|Dataware House: Data Warehouse
Etcd|ETCD: etcd
Exec Shield: Exec-Shield
EXIF|exif: Exif
Extranet: extranet
facter: Facter
Faq|faq|F.A.Q: FAQ
fault tolerant: fault-tolerant
fault-tolerance: fault tolerance
fedora project: Fedora™ Project
filestore|File Store: FileStore
Firewalld|firewallD|FirewallD: firewalld
Firewire|firewire: FireWire
FlatHub: Flathub
FlatPak: Flatpak
fortran: Fortran
Fqdn|fqdn: FQDN
gbps|GBPS: Gbps
gb|Gb: GB
GDBTK: Insight
gid|Gid: GID
Gimp|gimp: GIMP
git|GIT: Git
Gnome|gnome: GNOME
Gnu|gnu: GNU
Gpl|gpl: GPL
Graalvm|graalVM: GraalVM
Greenboot|green boots: greenboot
Grub: GRUB
GTK|Gtk|gtk: GTK+
hot rod|HotRod|hotrod: Hot Rod
HP Proliant: HP ProLiant
HTTP interface: management console
hyperthreading|hyper-threading: Hyper-Threading
HyperVisor|Hyperviser: hypervisor
IA64|ia64: Itanium
IBM z Systems: IBM Z
Ignite|Fuse Ignite: Fuse Online|Red Hat Fuse Online|Syndesis
ignition config: Ignition config
Image Builder: image builder
INSTALL_DIR|installDir: FUSE_HOME
Iops|IOPs: IOPS
Ip: IP
IPSec: IPsec
ipv4|IPV4|Ipv4: IPv4
ipv6|IPV6|Ipv6: IPv6
iSeries: ISeries
iso: ISO
Itanium2: Itanium 2
jar file: JAR file
Jbang|jbang: JBang
JBoss Clients: AMQ Clients
JBoss Data Grid: Data Grid
jetbrains|Jetbrains: JetBrains
Junit|junit: JUnit
Jvm|jvm: JVM
kbase|knowledge base: KIE base
kernel-based virtual machine: Kernel-based Virtual Machine
kernelspace: kernel space
key store: keystore
kickstart: Kickstart
kie API|Kie API|knowledge API: KIE API
kjar|kJAR: KJAR
knowledgebase: Knowledgebase
ksession|knowledge session: KIE session
Kubelet: kubelet
kubernetes|k8s: Kubernetes
kvm: KVM
Lan|lan: LAN
Librados|LIBRADOS: librados
Librbd|LIBRBD: librbd
Lightweight Directory Access Protocol over Secure Socket Layer: LDAPS
LINUX|linux: Linux
live-backup group: master-slave group
Lun|lun: LUN
master CA: IdM CA renewal server
master server: IdM server and replicas
Microprofile|micro-profile: MicroProfile
Microsoft Azure Portal: Microsoft Azure portal
Microsoft Windows Server: Windows Server
MoM|Mom|mom: MOM
Mongo\sDB|mongoDB|Mongodb|Mongo-db: MongoDB
MS(?!-DOS?)|MSFT|MicroSoft: Microsoft
MS-dos|Ms-Dos|ms-dos|MSDOS|msdos: MS-DOS
MTLS|m-TLS: mTLS
mutual tls|Mutual tls|Mutual TLS: mutual TLS
MYSQL|mySQL: MySQL
native interface: management CLI
network interface card: network interface controller (NIC)
objectclass: objectClass
Objective-C: Objective C
OCP: Red Hat OpenShift Container Platform
ODF: Red Hat OpenShift Data Foundation
Open InfiniBand|Infiniband: InfiniBand
openid connect|Openid Connect: OpenID Connect
openrewrite|Openrewrite|Open Rewrite: OpenRewrite
Openshift online|OO: Red Hat OpenShift Online
Operating Environment: operating environment
Operator Hub|Operator hub|Operatorhub|operatorhub: OperatorHub
Opex|Opex|OPEX|opEx: OpEx
Organization administrator|Org Admin|org admin: Organization Administrator
OS|Operating System: operating system
Overcloud: overcloud
Podman desktop: Podman Desktop
podman: Podman
popup|Pop-up: pop-up
Posix|posix: POSIX
Postscript: PostScript
Powershell|powershell: PowerShell
PPC|P-PC|PPC64: PowerPC
Ppp|ppp: PPP
prom|Prom: PROM
proof key for code exchange: Proof Key for Code Exchange
proof of concepts: proofs of concept
Properties editor: Properties View
pSeries: IBM eServer System p
puppet forge: Puppet Forge
puppet: Puppet
q & a|q&a|Q & A|Q&A: Q and A
qcow2|Qcow2: QCOW2
Qdmanage|QDMANAGE: qdmanage
Qdstat|QDSTAT: qdstat
Qeth|QETH: qeth
RAMdisk|ramdisk|RAM-disk: RAM disk
Ram|ram: RAM
RAW: raw
Red Hat JBoss Data Grid|JDG: Red Hat Data Grid
Red Hat JBoss EAP: Red Hat JBoss Enterprise Application Platform
Red Hat Network Satellite server: Red Hat Network Satellite Server
Red Hat Proxy: Red Hat Network Proxy Server
Red Hat Satellite Capsule server: Red Hat Satellite Capsule Server
Red Hat Satellite server: Red Hat Satellite Server
Red Hat satellite: Red Hat Satellite
Redboot|Red Boot: RedBoot
redis: Redis
RESTEASY|resteasy|Resteasy: RESTEasy
RHDS: Red Hat Directory Server
RHEL host|RHEL-H: Red Hat Enterprise Linux host
RHV: Red Hat Virtualization
Rom|rom: ROM
rpm: RPM
s-record|S-Record|s-Record|SREC: S-record
samba|SAMBA: Samba
Satellite server: Satellite Server
SE-Linux|S-E Linux|SE Linux|selinux: SELinux
Shadow Man|ShadowMan: Shadowman
Shadow passwords: shadow passwords
Shadow utilities: shadow utilities
Smallrye: SmallRye
smart NIC|Smart-NIC: SmartNIC
Smart State|smart state|Smart state|Smartstate|Analysis: SmartState analysis
socks: SOCKS
software collection|Software collection: Software Collection
Source Navigator: Source-Navigator^TM^
Spec: spec
Spice|spice: SPICE
Spring boot: Spring Boot
SR IOV: SR-IOV
Ssh|ssh: SSH
SSL handshake: TLS handshake
SSL(?!/TLS): SSL/TLS
standard Manager|standard environment: standalone Manager
Staroffice|Star Office: StarOffice
StartTLS|startTLS: STARTTLS
StartX: startx
STI|source to image: Source-to-Image (S2I)
SU: su
Subscription manifest: Subscription Manifest
Sys V|System V: SysV
system D|system D|SystemD|system d: systemd
Technology preview|technology preview: Technology Preview
The Operator Lifecycle Manager: Operator Lifecycle Manager
Tolapai|Intel Tolapai: Intel(R) EP80579 Integrated Processor
ttl: TTL
uid: UID
ULTRASPARC|UltraSparc: UltraSPARC
Unix|unix|UNIX-like: UNIX
url: URL
urn: URN
VCPU|vcpu: vCPU
VI: vi
VIM|vim: Vim
Virtual Desktop Server Management: VDSM
virtual-console|Virtual Console: virtual console
vlan|vLAN: VLAN
VM portal|vm portal|Virtual Machine Portal|User Portal: VM Portal
vnic|VNIC|Virtual Network Interface Card: vNIC
vnuma|VNUMA: vNUMA node
vpn: VPN
VS Code|VSCode|VisualStudioCode|VisualStudio Code: Visual Studio Code
VT-i|VT: Intel Virtualization Technology
wan: WAN
wca: WCA
web-UI|webUI: web UI
Webauthn|webAuthn|WebAuthN: WebAuthn
websocket|Websocket: WebSocket
Window-Maker|WindowMaker: Window Maker
Xemacs: XEmacs
xplat-cli|x-plat-cli|xplat cli|x-plat cli|X-PLAT CLI|X-PLAT-CLI|XPLAT-CLI|XPLAT CLI: Microsoft Azure Cross-Platform Command-Line Interface
Xp|xp: XP
Xterm: xterm

View file

@ -1,14 +0,0 @@
---
extends: existence
level: suggestion
link: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/conjunctions/
message: "Do not overuse beginning sentences with '%s'."
scope: paragraph
# source: https://github.com/redhat-documentation/vale-at-red-hat/tree/main/.vale/styles/RedHat/Conjunctions.yml
action:
name: remove
tokens:
- ^And
- ^But
- ^Or
- ^So

View file

@ -1,14 +0,0 @@
---
extends: substitution
ignorecase: true
level: warning
link: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/consciouslanguage/
message: Use '%s' rather than '%s.'
# source: "https://redhat-documentation.github.io/supplementary-style-guide/#conscious-language"
action:
name: replace
swap:
blacklist: blocklist
whitelist: allowlist
master(?! broker): primary|source|initiator|requester|controller|host|director|supplier
slave(?! broker): secondary|replica|responder|device|worker|proxy|performer|consumer

View file

@ -1,44 +0,0 @@
---
extends: substitution
ignorecase: true
level: suggestion
link: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/contractions/
message: "Avoid contractions. Use '%s' rather than '%s.'"
# source: "https://redhat-documentation.github.io/supplementary-style-guide/#contractions"
action:
name: replace
swap:
"aren't": is not
"can't": cannot
"couldn't": could not
"didn't": did not
"doesn't": does not
"don't": do not
"hasn't": has not
"haven't": have not
"how'll": how will
"how's": how is
"isn't": is not
"it'll": it will
"it's": it is
"shouldn't": should not
"that'll": that will
"that's": that is
"they'll": they will
"they're": they are
"wasn't": was not
"we'll": we will
"we're": we are
"we've": we have
"weren't": were not
"what'll": what will
"what's": what is
"when'll": when will
"when's": when is
"where'll": where will
"where's": where is
"who'll": who will
"who's": who is
"why'll": why will
"why's": why is
"won't": will not

View file

@ -1,183 +0,0 @@
---
extends: conditional
ignorecase: false
level: suggestion
link: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/definitions/
message: "Define acronyms and abbreviations (such as '%s') on first occurrence if they're likely to be unfamiliar."
# source: "IBM - Abbreviations, p. 1"
# Ensures that the existence of 'first' implies the existence of 'second'.
first: '\b([A-Z]{3,5}s?)\b'
second: '\(([A-Z]{3,5}s?)\)'
# ... with the exception of these:
exceptions:
- 'APIs?'
- 'CPUs?'
- 'CVEs?'
- 'DVDs?'
- 'GIDs?'
- 'NULL'
- 'PIDs?'
- 'ROMs?'
- 'RPMs?'
- 'UIDs?'
- 'URIs?'
- 'URLs?'
- ACPI
- AIX
- ARM
- ASCII
- ASP
- AWS
- BIND
- BIOS
- BMC
- CD
- CIDR
- CLI
- CNAME
- CSS
- CSV
- CUPS
- DEBUG
- DHCP
- DNF
- DNS
- DOM
- DOS
- DPI
- DRL
- DSL
- EIP
- ERROR
- FAQ
- FQDN
- FTP
- GAS
- GB
- GCC
- GCJ
- GDB
- GET
- GIF
- GIMP
- GNOME
- GNU
- GNUPro
- GPL
- GPU
- GRUB
- GTK+
- GUI
- GUID
- HP
- HTML
- HTTP
- HTTPS
- IAM
- IBM
- IDE
- IOPS
- IOV
- IP
- ISO
- IT
- JAR
- JPEG
- JSON
- JSX
- JVM
- KB
- KIE
- KVM
- LAN
- LDAP
- LESS
- LLDB
- LPAR
- LUKS
- LVM
- MAC
- MB
- MBR
- MDS
- mTLS
- NAT
- NET
- NFS
- NGINX
- NIC
- NOTE
- NTP
- NVDA
- OEM
- OSS
- PATH
- PC
- PDF
- PHP
- PIN
- PNG
- POSIX
- POST
- PPP
- PROM
- PXE
- QCOW2
- QEMU
- RADOS
- RAID
- RAM
- RBAC
- RBD
- REPL
- REST
- RFC
- RGW
- RHEL
- RSA
- SAML
- SAP
- SCM
- SCSI
- SCSS
- SDK
- SFTP
- SHA
- SOCKS
- SPEC
- SQL
- SSD
- SSH
- SSL
- SSSD
- SVG
- SVN
- SWAT
- TBD
- TCP
- TLS
- TODO
- TTL
- UDP
- UEFI
- UNIX
- USB
- UTC
- UTF
- UUID
- VAR
- VDO
- VDSM
- VGA
- VLAN
- VNC
- VPN
- WAN
- WCA
- XFS
- XML
- XSS
- YAML
- YUM
- ZIP
- ZTP

View file

@ -1,12 +0,0 @@
---
extends: existence
level: suggestion
link: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/ellipses/
message: "Avoid the ellipsis (...) except to indicate omitted words."
nonword: true
# source: "IBM - Ellipses, p.49"
action:
name: remove
tokens:
- '\.\.\.'
- "…"

View file

@ -1,15 +0,0 @@
---
extends: existence
level: warning
link: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/headingpunctuation/
message: "Do not use end punctuation in headings."
nonword: true
scope: heading
# source: "IBM - Periods in headings and titles, p. 61"
action:
name: edit
params:
- remove
- ".?!"
tokens:
- '[a-z0-9][.?!](?:\s|$)'

View file

@ -1,247 +0,0 @@
---
extends: capitalization
level: suggestion
link: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/headings/
match: $sentence
message: "Use sentence-style capitalization in '%s'."
scope: heading
# source: "IBM - Capitalization in headings and titles, p.16"
indicators:
- ":"
exceptions:
- API
- AWS
- Agroal
- Annobin
- Ansible
- Antora
- AppData
- AsciiDoc
- Asciidoctor
- AssertJ
- Azure
- Basic authentication
- Basic HTTP authentication
- BOM
- Bierner
- Bitbucket
- Bonjour
- Bouncy Castle
- Btrfs
- Bugzilla
- CDs
- CR
- CRD
- CRDs
- CRs
- Camel
- CapEx
- CentOS
- Ceph
- Certificate Authorities
- Che-Theia
- Ciphertext
- Civetweb
- ClassLoader
- Classloader
- Cloudbursting
- Cloudwashing
- CodeReady
- Community
- ConfigMap
- ConfigMaps
- Containerfile
- Containerfiles
- Cookiecutter
- Ctrl
- Cygmon
- DNS
- DaemonSet
- Datadog
- Dev
- DevOps
- DevWorkspace
- Dex
- Docker
- Dockerfile
- Dockerfiles
- Dotnet
- Dyninst
- Eclipse
- Electron
- Endevor
- Endian
- Esprima
- Exif
- Fabrice
- Failsafe
- Fernflower
- Flathub
- Flatpak
- Flatpak Builder
- Fortran
- Funqy
- GCC
- GTKplus
- GUI
- Git
- GitHub
- GitHub Action
- GitLab
- GitLab Code Quality
- Gluster
- GraalVM
- Gradle
- GraphQL
- Grayscale
- GTK
- HTTP
- HTTPS
- Hashicorp
- Helgrind
- Helm
- Hibernate
- Homebrew
- IBM
- IBM Cloud
- ID
- IDE
- IDEs
- IDs
- IPSec
- ISeries
- InfiniBand
- Infinispan
- Intelephense
- IntelliJ
- Itanium
- JAR file
- JBang
- JUnit
- JVM
- Jakarta
- Jandex
- Java
- Jave
- JetBrains
- Jira
- Jolokia
- Joyent
- Kibana
- Kind
- Knative
- Knowledgebase
- Kogito
- Kompose
- Kubespray
- Kylin
- Laravel
- Lombok
- Makefile
- Mandrel
- Mattermost
- Maven
- MicroProfile
- Microsoft
- Middleware
- Minikube
- Minishift
- Mirantis
- Mockito
- MongoDB
- MySQL
- Nagios
- Narayana
- Neoverse
- NetcoredebugOutput
- Netty
- Newdoc
- Nginx
- Node.js
- NuGet
- OAuth
- ORM
- OmniSharp
- OpEx
- OpenID Connect
- OpenJDK
- OpenRewrite
- OpenShift
- OpenTracing
- PHP
- Podman
- Podman Desktop
- PostScript
- PostgreSQL
- PowerPC
- PowerShell
- Productize
- Productized
- Prometheus
- Proof Key for Code Exchange
- Pytorch
- Qt
- Quarkiverse
- Quarkus
- Quiltflower
- Qute
- RESTEasy
- Red Hat
- RedBoot
- Redis
- Redistributions
- SCM
- SDK
- SELinux
- SVG
- Sakila
- Semeru
- Shadowman
- SmallRye
- Software Development Kit
- Software Development Kits
- Spotify
- StarOffice
- Suchow
- SysV
- System
- Technology Preview
- Tekton
- Telekom
- Tensorflow
- Texinfo
- Toolset
- Traefik
- URI
- URIs
- URL
- URLs
- Uber
- UltraSPARC
- Vale
- Valgrind
- Velero
- Vert.x
- WebAuthn
- WebSocket
- Webview
- Webviews
- Wildfly
- Window Maker
- Windows
- Windows Subsystem for Linux
- Woopra
- Wordpress
- XEmacs
- Yana
- Yeoman
- Zowe
- cgroup
- eServer
- mutual TLS
- mTLS
- qeth
- startx
- vNIC
- vNUMA
- xterm

View file

@ -1,8 +0,0 @@
---
extends: existence
level: suggestion
link: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/oxfordcomma/
message: "Use the Oxford comma in '%s'."
# source: "IBM - Commas between clauses, p.45"
tokens:
- '(?:[^,]+,){1,}\s\w+\sand'

View file

@ -1,179 +0,0 @@
---
extends: existence
ignorecase: false
level: suggestion
scope: [list, sentence]
link: https://redhat-documentation.github.io/asciidoc-markup-conventions
message: "Consider wrapping this Pascal or Camel case term ('%s') in backticks."
# source: https://github.com/redhat-documentation/vale-at-red-hat/tree/main/.vale/styles/RedHat/PascalCamelCase.yml
tokens:
#PascalCase
- ([A-Z]+[a-z]+){2,}
- ([A-Z]+[a-z]+[A-Z]+){1,}
- ([A-Z]+[A-Z]+[a-z]+){1,}
#camelCase
- ([a-z]+)([A-Z]+[a-z]+){1,}
exceptions:
- '\b[A-Z]{2,}s?'
- 'vCPUs?'
- 3scale
- AGPLv
- AMQ
- API
- AppStream
- AsciiDoc
- AssertJ
- BaseOS
- BitBucket
- BlueStore
- CaaS
- camelCase
- CapEx
- CentOS
- CephFS
- CheckTree
- ClassLoader
- CloudForms
- CodeReady
- ConfigMaps?
- ConnectX
- Convert2RHEL
- CoreOS
- DaemonSet
- DDoS
- DevOps
- DevWorkspace
- DNSSec
- eServer
- eXpress
- eXtenSion
- FaaS
- FCoE
- FileStore
- FireWire
- FreeRADIUS
- GbE
- GiB
- GitHub
- GitLab
- GitOps
- GlusterFS
- GNUPro
- GnuTLS
- GraalVM
- GraphQL
- GTID
- HashBase
- HdrHistogram
- Helm
- HyperShift
- IaaS
- IBoE
- IconBurst
- IdM
- IKEv
- InfiniBand
- InnoDB
- IntelliJ
- IntelliSense
- IPoIB
- IPsec
- IPv
- ISeries
- JavaScript
- JBoss
- JetBrains
- JUnit
- KiB
- LangTags
- LGPLv
- libOSMesa
- LibreOffice
- libXNVCtrl
- LightPulse
- LinuxONE
- LiquidIO
- ManageIQ
- MariaDB
- MegaRAID
- MiB
- MicroProfile
- MongoDB
- MoreUtils
- MySQL
- NetBIOS
- NetcoredebugOutput
- NetWeaver
- NetworkManager
- NetXen
- NetXtreme
- NFSv
- NuGet
- NVidia
- NVMe
- OAuth
- objectClass
- OmniSharp
- OneConnect
- OpenEXR
- OpenID
- OpenIPMI
- OpenJDK
- OpenRewrite
- OpenSCAP
- OpenShift
- OpenSSH
- OpenSSL
- OpenStack
- OpenTracing
- OperatorHub
- OpEx
- OSBuild
- PaaS
- PackageKit
- PathTools
- PCIe
- PipeWire
- PostgreSQL
- PostScript
- PowerPC
- PowerShell
- ProLiant
- PulseAudio
- PyPA
- PyPI
- QLogic
- ReaR
- RedBoot
- relaxngDatatype
- RESTEasy
- RHEL
- RoCE
- SaaS
- SeaBIOS
- SELinux
- SmallRye
- SmartNIC
- SmartState
- SQLite
- StarOffice
- STMicroelectronics
- SuperLU
- SysV
- TiB
- TuneD
- TypeScript
- UltraSPARC
- USBGuard
- vDisk
- vHost
- vSphere
- WebAuthn
- WebSocket
- WireGuard
- XEmacs
- xPaaS
- XString
- XWayland
- YouTube
- ZCentral

View file

@ -1,186 +0,0 @@
---
extends: existence
ignorecase: true
level: suggestion
link: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/passivevoice/
message: "'%s' is passive voice. In general, use active voice. Consult the style guide for acceptable use of passive voice."
# source: "https://redhat-documentation.github.io/supplementary-style-guide/#prerequisites; IBM - Voice, p.35"
raw:
- \b(am|are|were|being|is|been|was|be)\b\s*
tokens:
- '[\w]+ed'
- awoken
- beat
- become
- been
- begun
- bent
- beset
- bet
- bid
- bidden
- bitten
- bled
- blown
- born
- bought
- bound
- bred
- broadcast
- broken
- brought
- built
- burnt
- burst
- cast
- caught
- chosen
- clung
- come
- cost
- crept
- cut
- dealt
- dived
- done
- drawn
- dreamt
- driven
- drunk
- dug
- eaten
- fallen
- fed
- felt
- fit
- fled
- flown
- flung
- forbidden
- foregone
- forgiven
- forgotten
- forsaken
- fought
- found
- frozen
- given
- gone
- gotten
- ground
- grown
- heard
- held
- hidden
- hit
- hung
- hurt
- kept
- knelt
- knit
- known
- laid
- lain
- leapt
- learnt
- led
- left
- lent
- let
- lighted
- lost
- made
- meant
- met
- misspelt
- mistaken
- mown
- overcome
- overdone
- overtaken
- overthrown
- paid
- pled
- proven
- put
- quit
- read
- rid
- ridden
- risen
- run
- rung
- said
- sat
- sawn
- seen
- sent
- set
- sewn
- shaken
- shaven
- shed
- shod
- shone
- shorn
- shot
- shown
- shrunk
- shut
- slain
- slept
- slid
- slit
- slung
- smitten
- sold
- sought
- sown
- sped
- spent
- spilt
- spit
- split
- spoken
- spread
- sprung
- spun
- stolen
- stood
- stridden
- striven
- struck
- strung
- stuck
- stung
- stunk
- sung
- sunk
- swept
- swollen
- sworn
- swum
- swung
- taken
- taught
- thought
- thrived
- thrown
- thrust
- told
- torn
- trodden
- understood
- upheld
- upset
- wed
- wept
- withheld
- withstood
- woken
- won
- worn
- wound
- woven
- written
- wrung

View file

@ -1,9 +0,0 @@
= README for Rules from the IBM Style Guide
All rights for the IBM Style Guide belong to IBM.
Our sources of inspiration:
* link:https://github.com/errata-ai/IBM[The primary Vale implementation of the IBM Style Guide]
* https://www.ibm.com/developerworks/library/styleguidelines/index.html[The DeveloperWorks version of the IBM Style Guide]

View file

@ -1,13 +0,0 @@
<!-- vale off -->
Copyright © 20142015, Jordan Suchow, Michael Pacer, and Lara A. Ross
All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

View file

@ -1,28 +0,0 @@
<!-- vale off -->
Based on [write-good](https://github.com/btford/write-good).
> Naive linter for English prose for developers who can't write good and wanna learn to do other stuff good too.
```
The MIT License (MIT)
Copyright (c) 2014 Brian Ford
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
```

View file

@ -1,12 +0,0 @@
---
extends: readability
grade: 21
level: suggestion
link: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/readabilitygrade/
message: "Grade level (%s) too high."
metrics:
- Automated Readability
- Coleman-Liau
- Flesch-Kincaid
- Gunning Fog
- SMOG

View file

@ -1,11 +0,0 @@
---
extends: substitution
ignorecase: false
level: suggestion
link: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/releasenotes/
message: "For release notes, consider using '%s' rather than '%s'."
# source: "https://redhat-documentation.github.io/supplementary-style-guide/#release-notes"
# swap maps tokens in form of bad: good
swap:
Now: With this update
Previously: Before this update

View file

@ -1,10 +0,0 @@
---
extends: repetition
message: "'%s' is repeated!"
level: warning
link: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/repeatedwords/
ignorecase: false
alpha: true
tokens:
- '[^\s\.]+'
- '[^\s]+'

View file

@ -1,14 +0,0 @@
---
extends: existence
ignorecase: true
level: suggestion
link: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/selfreferentialtext/
message: "Avoid using self-referential text such as '%s'."
# source: "IBM - Audience and medium, p. 22"
tokens:
- this topic
- this module
- this assembly
- this chapter
- this section
- this subsection

View file

@ -1,9 +0,0 @@
---
extends: occurrence
level: suggestion
link: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/sentencelength/
message: "Try to keep sentences to an average of 32 words or fewer."
scope: sentence
# source: "IBM - Conversational style"
max: 32
token: \b(\w+)\b

View file

@ -1,119 +0,0 @@
---
extends: substitution
ignorecase: true
level: suggestion
link: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/simplewords/
message: "Use simple language. Consider using '%s' rather than '%s'."
# source: "IBM - Conversational style; http://www.plainlanguage.gov/howto/wordsuggestions/simplewords.cfm"
swap:
"approximate(?:ly)?": about
"objective(?! C?)": aim|goal
absent: none|not here
abundance: plenty
accelerate: speed up
accentuate: stress
accompany: go with
accomplish: carry out|do
accorded: given
accordingly: so
accrue: add
accurate: right|exact
acquiesce: agree
acquire: get|buy
"(?<!an |the |IP |IPv[46] |MAC )address": discuss
addressees: you
adjacent to: next to
adjustment: change
admissible: allowed
advantageous: helpful
advise: tell
aggregate: total
aircraft: plane
alleviate: ease
allocate: assign|divide
alternatively: or
alternatives: choices|options
ameliorate: improve
amend: change
anticipate: expect
apparent: clear|plain
ascertain: discover|find out
assistance: help
attain: meet
attempt: try
authorize: allow
belated: late
bestow: give
cease: stop|end
collaborate: work together
commence: begin
compensate: pay
component: part
comprise: form|include
concerning: about
confer: give|award
consequently: so
consolidate: merge
constitutes: forms
contains: has
convene: meet
demonstrate: show|prove
depart: leave
designate: choose
desire: want|wish
determine: decide|find
detrimental: bad|harmful
disclose: share|tell
discontinue: stop
disseminate: send|give
eliminate: end
elucidate: explain
employ: use
enclosed: inside|included
encounter: meet
endeavor: try
enumerate: count
equitable: fair
equivalent: equal
exclusively: only
expedite: hurry
facilitate: ease
females: women
finalize: complete|finish
frequently: often
identical: same
incorrect: wrong
indication: sign
initiate: start|begin
itemized: listed
jeopardize: risk
liaise: work with|partner with
maintain: keep|support
methodology: method
modify: change
monitor: check|watch
multiple: many
necessitate: cause
notify: tell
numerous: many
obligate: bind|compel
optimum: best|most
permit: let
portion: part
possess: own
previous: earlier
previously: before
prioritize: rank
procure: buy
provide: give|offer
purchase: buy
relocate: move
solicit: request
state-of-the-art: latest
subsequent: later|next
substantial: large
sufficient: enough
terminate: end
transmit: send
utilization: use
utilize: use

View file

@ -1,20 +0,0 @@
---
extends: existence
ignorecase: true
level: warning
link: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/slash/
message: "Use either 'or' or 'and' in '%s'"
# source: "IBM - Slashes, p. 68"
tokens:
- '(?<!/)\w+/\w+'
exceptions:
- "client/server"
- "I/O"
- "[Ii]nput/[Oo]utput"
- "N/A"
- "SSL/TLS"
- "upstream/downstream"
- "z/OS"
- "z/OSMF"
- "0/"
- "C/C"

View file

@ -1,10 +0,0 @@
---
extends: existence
level: error
link: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/spacing/
message: "Keep one space between words in '%s'."
nonword: true
# source: https://docs.microsoft.com/en-us/style-guide/punctuation/periods
tokens:
- "[a-z][.?!] {2,}[A-Z]"
- "[a-z][.?!][A-Z]"

View file

@ -1,410 +0,0 @@
#file: noinspection IncorrectFormatting
---
extends: spelling
level: warning
link: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/spelling/
message: "Use correct American English spelling. Did you really mean '%s'?"
# source: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/spelling/
# A "filter" is a case-sensitive regular expression specifying words to ignore during spell checking.
# Spelling rule applies to individual words
filters:
- '\.NET'
- 'I/O'
- 'Node\.js'
- "[aA]ccessor"
- "[aA]llowlist"
- "[aA]utostart"
- "[bB]ackfilling"
- "[bB]ackported"
- "[bB]acktrace"
- "[bB]indable"
- "[bB]oolean"
- "[bB]reakpoint"
- "[bB]reakpoints"
- "[cC]he"
- "[cC]lassloading"
- "[cC]olocate"
- "[cC]onfig"
- "[dD]eclaratively"
- "[dD]ecompiler"
- "[dD]eserialization"
- "[dD]esynchronize"
- "[dD]esynchronized"
- "[dD]ev[wW]orkspace"
- "[dD]evfile"
- "[dD]evfiles"
- "[dD]ownstream"
- "[dD]ownstreaming"
- "[eE]xposal"
- "[Ff]actories"
- "[Ff]actory"
- "[fF]ailback"
- "[fF]ailover"
- "[gG]bps"
- "[gG]it"
- "[gG]rafana"
- "[hH]ardcoding"
- "[hH]eatmap"
- "[hH]ostname"
- "[hH]yperconverged"
- "[iI]node"
- "[iI]tem"
- "[jJ]et[bB]rains"
- "[jJ]ournald"
- "[jJ]ournaling"
- "[kK]eycloak"
- "[kK]eylime"
- "[kK]eyring"
- "[kK]eyrings"
- "[lL]ibvirt"
- "[lL]icensor"
- "[lL]iveness"
- "[lL]oopback"
- "[mM]atrixes"
- "[mM]ebibytes"
- "[mM]iddleware"
- "[mM]illicores"
- "[mM]ixin"
- "[mM]ixins"
- "[mM]odularization"
- "[mM]ulticluster"
- "[mM]ultihost"
- "[mM]ultinode"
- "[mM]ultithread"
- "[mM]ultitenant"
- "[mM]ultiuser"
- "[mM]ultizone"
- "[nN]amespace"
- "[nN]amespaces"
- "[oO]nboarding"
- "[oO]perator"
- "[oO]verridable"
- "[pP]reconfigured"
- "[pP]regenerated"
- "[pP]ulldown"
- "[pP]repend"
- "[pP]repended"
- "[pP]roductize"
- "[pP]roductized"
- "[rR]eadonly"
- "[rR]ebalance"
- "[rR]ebalances"
- "[rR]ebalancing"
- "[rR]ebase"
- "[rR]ebased"
- "[rR]ecertification"
- "[rR]ecertifications"
- "[rR]eshard"
- "[rR]esharding"
- "[rR]eshards"
- "[rR]esyncing"
- "[rR]ollout"
- "[rR]ollouts"
- "[rR]oundtable"
- "[rR]oundtables"
- "[rR]uleset"
- "[rR]unlevel"
- "[rR]unlevels"
- "[rR]untime"
- "[rR]untimes"
- "[sS]crollbar"
- "[sS]erializer"
- "[sS]erialization"
- "[sS]erializable"
- "[sS]erverless"
- "[sS]ervlet"
- "[sS]harding"
- "[sS]ysctl"
- "[Ss]u"
- "[sS]ubcommand"
- "[sS]ubcommands"
- "[sS]ubmenu"
- "[sS]ubmenus"
- "[sS]ubnetwork"
- "[sS]ubnetworks"
- "[sS]ubpackage"
- "[sS]ubpackages"
- "[sS]ubpath"
- "[sS]ubpaths"
- "[sS]ubstep"
- "[sS]ubsteps"
- "[sS]ubtest"
- "[sS]ubtests"
- "[sS]ubuser"
- "[sS]ubusers"
- "[sS]ubvolume"
- "[sS]ubvolumes"
- "[sS]ystemd"
- "[tT]emplated"
- "[tT]heia"
- "[tT]olerations"
- "[tT]raceback"
- "[tT]ruststore"
- "[uU]ncomment"
- "[uU]ndercloud"
- "[uU]ninstallation"
- "[uU]nmount"
- "[uU]nmounting"
- "[uU]nported"
- "[uU]nstaged"
- "[uU]ntrusted"
- "[uU]psell"
- "[uU]pselling"
- "[vV]alidator"
- "Let\\'s Encrypt"
- adoc
- AGPLv
- Agroal
- Annobin
- Ansible
- Antora
- API
- Applixware
- Asciidoctor
- AssertJ
- autolink
- aws
- AWS
- Azure
- Bierner
- Bitbucket
- BOM
- Bonjour
- Bouncy Castle
- btn
- Btrfs
- Bugzilla
- camelCase
- CentOS
- Ceph
- cephfs
- cgroup
- Che-Theia
- Ciphertext
- Civetweb
- classloader
- classpath
- Cloudbursting
- Cloudwashing
- CodeReady
- ConfigMaps?
- Containerfile
- Containerfiles
- Cookiecutter
- CPUs
- CR
- CRD
- CRDs
- CRs
- CSIDriver
- CSINode
- CSVs
- Ctrl
- CVEs
- Cygmon
- DaemonSet
- Datadog
- Dev
- DevWorkspace
- Dex
- DNS
- Docker
- Dockerfile
- Dockerfiles
- Dotnet
- Dyninst
- Endevor
- Endian
- endif
- eServer
- Esprima
- etcd
- Exif
- extranet
- Fabrice
- Facter
- Failsafe
- FDs
- Fernflower
- firewalld
- Flathub
- Flatpak
- Fortran
- Funqy
- GCC
- GIDs
- GitHub
- GitLab
- Gluster
- GNUPro
- GraalVM
- Gradle
- GraphQL
- greenboot
- Grayscale
- GTIDs?
- GUI
- Hashicorp
- Helgrind
- Helm
- Homebrew
- htmltest
- http
- HTTP
- https
- HTTPS
- IDE
- IDEs
- IKEv
- Infinispan
- Intelephense
- IntelliJ
- IPsec
- ISeries
- IPPool
- IPsec
- IPv
- ISVs
- Itanium
- Jakarta
- Jandex
- Java
- Jave
- JBang
- JBoss
- Jira
- Jolokia
- Joyent
- JUnit
- jvm
- JVM
- Kafka
- kbd
- keystore
- Kibana
- Knative
- Knowledgebase
- Kogito
- Kompose
- kubelet
- Kubespray
- Kylin
- Laravel
- LGPLv
- librados
- librbd
- libOSMesa
- Lombok
- Makefile
- Mattermost
- Maven
- MicroProfile
- Microsoft
- Minikube
- Minishift
- Mirantis
- Mockito
- MongoDB
- Multipath
- MySQL
- Nagios
- Narayana
- Neoverse
- NetcoredebugOutput
- Netty
- Newdoc
- NFSv
- Nginx
- npm
- NuGet
- NVidia
- NVMe
- OAuth
- objectClass
- ocp
- OmniSharp
- OpenID
- OpenJDK
- OpenRewrite
- OpenShift
- OpenTracing
- OSBuild
- osd
- OSs
- PCIe
- PDFs?
- PHP
- PIDs
- Podman
- PostgreSQL
- PowerShell
- Prometheus
- proxied
- Pytorch
- qdmanage
- qdstat
- qeth
- QLogic
- Quarkiverse
- Quarkus
- Quiltflower
- Qute
- Realtime
- Redis
- Redistributions
- relaxngDatatype
- RESTEasy
- Restic
- Rolfe
- Rollup
- ROMs
- rootful
- rootless
- RPMs
- Sakila
- sbt
- SCM
- SELinux
- Semeru
- Shadowman
- SLAs
- SmallRye
- Spotify
- startx
- STMicroelectronics
- Suchow
- SVG
- Symfony
- Tekton
- Telekom
- Tensorflow
- Texinfo
- Toolset
- Traefik
- Uber
- UIDs
- URIs?
- url
- URLs?
- USBGuard
- Vale
- Valgrind
- vDisk
- Velero
- Vert.x
- vHost
- VMs
- vsix
- vSphere
- WebAuthn
- Webpack
- WebSocket
- Wildfly
- Woopra
- Wordpress
- XString
- XWayland
- Yana
- Yeoman
- ZCentral
- Zowe

View file

@ -1,329 +0,0 @@
---
extends: substitution
ignorecase: true
level: error
link: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/termserrors/
message: "Use '%s' rather than '%s'."
# source: "https://redhat-documentation.github.io/supplementary-style-guide/#glossary-terms-conventions; IBM - Appendix C. Word usage, p. 300"
action:
name: replace
# swap maps tokens in form of bad: good
swap:
"(?:Ctrl|control)-click": press Ctrl and click
"(?<!kernel )oops": kernel oops
"(?<!make the )transition": "make the transition|move|migrate|change"
"(?<!mobile |cell )phone": "telephone|cell phone|mobile phone"
"(?<!Mozilla )Firefox": Mozilla Firefox
"(?<!Mozilla )Thunderbird": Mozilla Thunderbird
"[bB]asic [aA]uth": Basic HTTP authentication (first instance)|Basic authentication
"a lot(?: of)?": many|much
"AI": Assisted Installer
"backward(?:-)?compatible": compatible with earlier versions
"bottle neck|bottle-neck": bottleneck
"bottom(?:-)?left": lower left|lower-left
"bottom(?:-)?right": lower right|lower-right
"broad cast|broad-cast": broadcast
"down(?:-)?level": earlier|previous|not at the latest level
"IPI": installer-provisioned infrastructure
"mash(?: )?up": create
"non-English(?!-language?)": in languages other than English|non-English-language
"pop-up (?:blocker|killer)": software to block pop-up ad windows
"re(?:-)?occur": recur
"sort(?:-|/)?merge": sort|merge
"top(?:-)?left": upper left|upper right|upper-left|upper-right
"top(?:-)?right": upper left|upper right|upper-left|upper-right
"UPI": user-provisioned infrastructure
# "app(?:.)": app
'(?<!\/)etc(?!\/)': and so on
'(?<!IBM\s)S\/390|S90|S\s390': IBM S/390
'(?<!self-)hosted engine(?! host)|hosted-engine(?! host)': self-hosted engine
'(?<!virtual )floppy disk': diskette|diskette drive
'(?<!virtual )floppy drive': diskette|diskette drive
'(?<!virtual )floppy(?!\sdisk|\sdrive)': diskette|diskette drive
'(?<!virtual )hard drive': hard disk|hard disk drive
'\b(?:eg|e\.g\.)[\s,]': for example
'\b(?:ie|i\.e\.)[\s,]': that is
'fixed\sdisk\sdrive': hard disk drive
'virtual\shard\sdisk': virtual hard drive
a number of: several
abort: cancel|stop
administrate: administer
advisor: adviser
air wall: air gap
all caps: uppercase
alright|all right: "correct|as expected"
analyse: analyze
and/or: a or b|a, b, or both
as long as: if|provided that
as per: according to|as|as in
autodetect: auto-detect
back-level: earlier|previous|not at the latest level
bi-monthly: bimonthly
bi-weekly: biweekly
Big Blue: IBM
blink: flash
blue screen of death: stop error
boot diskette: boot disk
bootloader: boot loader
breadcrumbing: breadcrumb trail
bugfix: bug fix
builtin|built in: built-in
byte code: bytecode
canned: preplanned|preconfigured|predefined
case insensitive: not case-sensitive
catastrophic error: unrecoverable error
CBE: Common Base Event
CBTS: CICS BTS|BTS
CD burner|burner: CD writer
centre: center
cipher text|cyphertext|cypher text|cipher-text|cypher-text: ciphertext
cloud-bursting: cloudbursting
cloud-washing: cloudwashing
co-locate|collocate: colocate
cold backup: offline backup
cold boot: hardware restart
cold start: hardware restart
colour: color
comes with: includes
comma delimited|commadelimited: comma-delimited
comma-delimited values|comma delimited values|comma separated values: comma-separated values
command driven|commanddriven: command-driven
command-language: command language
componentization: component-based development|component model|component architecture|shared components
componentize: develop components
comprised of: consist of
computer farm|computer ranch: server cluster|server farm
connect with: connect to
container based: container-based
containerised: containerized
context menu: menu|pop-up menu
contextual help: help|context-sensitive help
cross site scripting: cross-site scripting
crossplatform|cross platform: cross-platform
daisy-chain|daisychain: daisy chain
datacenter|data-center|data centre|datacentre: data center
datamirroring|data-mirroring: data mirroring
datapath: data path
datum: data
de-bug: debug
debuggable: debug
deconfigure: unconfigure
deinstall: uninstall
deinstallation: uninstallation
demilitarized zone: DMZ
demon: daemon
deployment configuration: deployment
depress: press|type
deregister: unregister
desire: want|required
desire|wish: need
desk top|desk-top: desktop
destroy: delete from the database
details pane: details view
different than|different to: different from
disklabel|disk-label: disk label
dismount: demount|unmount|remove
domain mode: managed domain
domainname|domain-name: domain name
down-load|down load: download
down-stream|down stream: downstream
downgrade: upgrade|fallback|fall back|rollback|roll back
downward compatible: compatible with earlier versions
drag and drop: drag
drill up: navigate
dualboot|dual boot: dual-boot
e-fix: fix|interim fix
eFix: fix|interim fix
emphasise: emphasize
end user: user
end-user interface: graphical interface|interface
enum: data enumeration
env: environment
EUI: graphical user interface|interface
fill in: complete|enter|specify
finalise: finalize
firm ware|firm-ware: firmware
flavor: version|method
floating-point: floating point
focussed: focused
fore-ground|forground: foreground
forward compatible: compatible with later versions
gray-scale|gray scale: grayscale
gzip: compress
gzipped: archive|compressed file
hard file: hard disk|hard disk drive
hardcode: hard code
hardcoded: hard-coded
healthcheck|health-check: health check
helpdesk|help-desk: help desk
hence: therefore
hosted engine host|hosted-engine host|self-hosted engine host|(?<!self-)hosted engine node|hosted-engine node: self-hosted engine node
hostgroup: host group
hot-line: hotline
hotadd|hot-add: hot add
hotplug|hot-plug: hot plug
hotswap|hot-swap: hot swap
hyper-converged: hyperconverged
i-fix: interim fix
i-Fix: interim fix
IBM's: IBM
ifix: interim fix
iFix: interim fix
in order to: to
in other words: for example|that is
in spite of: regardless of|despite
in the event: in case|if|when
inactivate: deactivate
information technology: IT
insure: ensure
Internet address: IP address|URL|Internet email address|web address
irrecoverable: unrecoverable
keep in mind: remember
kernelspace: kernel-space
labour: labor
laptop: notebook
large page|super page: huge page
launch: start|open
learnt: learned
leave out: omit
left-hand: left
leverage: use
line cord: power cable|power cord
Linux specific|chip specific: specific
live broker: master broker
live only: live-only
load-balance|load-balancing: load balance
look at: examine
lots of|bunches of: many
main directory: root directory
make sure: verify
manpage: man page
matrices: matrixes
memory stick: USB flash drive
menu driven|menudriven: menu-driven
microcomputer: PC
motherboard: system board
mouse over: point to|move the mouse pointer over
mouse-button|mousebutton: mouse button
multi site|multi-site: multisite
multi-processing: multiprocessing
multi-tenant: multitenant
network-centric computing: network computing
nonrecoverable: unrecoverable
nonsecure|non-secure: insecure
notion: concept
offline storage: auxiliary storage
OK button: OK
okay: OK
on ramp: access method
on the fly: dynamically|as needed|in real time|immediately
on the other hand: however|alternatively|conversely
on-ramp: access method
op-code: opcode
openshit: OpenShift
open-source|OpenSource|opensource: open source
organise: organize
organised: organized
organising: organizing
over-ride|over ride: override
pain point: challenge|concern|difficulty|issue
parent task: parent process
passive broker: slave broker
perfcounter: performance counter
perimeter network: DMZ
plaintext|plain-text|cleartext|clear text: plain text
plug in|plug ins: plugin
pojo: data model
power down: turn off
power off: turn off
power on: turn on
preload: preinstall|preinstalled
preloaded: preinstall|preinstalled
prepend: add a prefix to
proof of concepts: proofs of concept|proofs of concept
pseudo ops|pseudoops: pseudo-ops
pull-down: pulldown
recognise: recognize
regex: regular expression
remote-access server: remote access server
remote-access: remote access
right double-click: double right-click
right now: now
right-hand: right
round table: roundtable
rule of thumb: rule
run level|run-level: runlevel
sanity check: test|evaluate|validate|verify
sanity test: test|evaluate|validate|verify
screensaver: screen saver
scroll bar|scroll-bar: scrollbar
secondary storage: auxiliary storage
selection button: left mouse button
send out: emit
serial database: nonpartitioned database environment
sharename|Sharename: share name
shift-click: press Shift and click
ship: include|included
Simple Object Access Protocol: SOAP
single quote mark: single quotation mark
single quote: single quotation mark
SME routine: session management exit routine
snapset|snapsets: snapshot set
soundcard|sound-card: sound card
specfile: spec file
spelt: spelled
stand-alone: standalone
standalone mode: standalone server
start up: start
straight forward|straight-forward: straightforward
sub version|(?<!Apache )Subversion: sub-version
sub-command: subcommand
sub-directory: subdirectory
sub-menu: submenu
sub-package: subpackage
sunset: withdraw from service|withdraw from marketing|discontinue|no longer support
super-user|super user: superuser
swapspace: swap space
switch off: turn off
switch on: turn on
sysprep tool|sysprep process|sysprep function: sysprep
tarball: tar file
terminate: end|stop
text based: text-based
textmode|text-mode: text mode
the installer: installation program
thin provisioned|thinly provisioned|thinly-provisioned: thin-provisioned
thru: through|throughput
thumbstick: USB flash drive
thus: therefore
tier-one|tier 1: tier-1
timeframe|time-frame: time frame
toggle off: toggle
touchscreen: touch-sensitive screen
trust store: truststore
typo: typing error|typographical error
uncheck: clear
uncompress: decompress
undeploy: remove|withdraw
unselect: clear|deselect
untar: extract
unzip: extract|decompress
up-grade|up grade: upgrade
up-sell: upsell
up-selling|up selling: upselling
up-stream|up stream: upstream
up-time|up time: uptime
upward compatible: compatible with later versions
utilize: use
versus: compared to
video-mode|videomode: video mode
virtual diskette drive: virtual floppy drive
virtual diskette: virtual floppy disk
vs: compared to
warning notice: attention notice
web-enable: enable for the web
wish: want
wish|would like: want
xsite: cross-site replication
zero out: zero
zonegroup|zone-group: zone group

View file

@ -1,41 +0,0 @@
---
extends: substitution
ignorecase: false
level: suggestion
link: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/termssuggestions/
message: "Depending on the context, consider using '%s' rather than '%s'."
# source: "https://redhat-documentation.github.io/supplementary-style-guide/#glossary-terms-conventions; IBM - Appendix C. Word usage, p. 300"
action:
name: replace
swap:
"(?<!,) which": ", which (non restrictive clause preceded by a comma)|that (restrictive clause without a comma)"
"(?<!by) using": by using|that uses
"(?<!such )as": because|while
", that": ", which (non restrictive clause preceded by a comma)|that (restrictive clause without a comma)"
"[Bb]are metal|[Bb]are-metal(?! clusters?| compute| configuration| controls?| environments?| equipment| events?| hardware| hosts?| infrastructure| installations?| installers?| machines?| media| nodes?| provisioning| servers?| workers?)": bare metal (noun)|bare-metal (adjective)
"shell(?! prompt| script)": shell prompt
and so on: "appropriate descriptive wording, unless you list a clear sequence of elements"
between: " - ' to indicate a 'range of numbers"
Bps|bps: Bps (bytes per second)|bps (bits per second)
CD|cd: cd (change directory command)|CD (compact disc)
channel: repository
client side|client-side: client-side (adjective)| client side (noun)
Cloud: cloud
code: write
crash: fail|lock up|stop|stop responding
functionality: functions # IBM
Hammer|x86_64|x86-64|x64|64-bit x86: AMD64
input|type: enter (followed by the text to enter in monospace) # https://redhat-documentation.github.io/supplementary-style-guide/#text-entry
jar: compress|archive (verb)
Navigate|navigate: '"click", "select", "browse", or "go to"'
recommend: direct users to take the recommended action
refer to: see
roll-out|roll out|rollout: roll out (verb)|rollout (noun)
Router: AMQ Interconnect
segfault: segmentation fault
tar: compress|archive
thru|through: "' - ' (range)|by using|finished|completed"
unjar: extract (verb)
user space|userspace|user-space: user space (noun)| user-space (modifier)
zip: compress
information on: information about

View file

@ -1,22 +0,0 @@
---
extends: substitution
ignorecase: true
level: warning
link: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/termswarnings/
message: "Consider using '%s' rather than '%s' unless updating existing content that uses the term."
# source: "https://redhat-documentation.github.io/supplementary-style-guide/#glossary-terms-conventions; IBM - Appendix C. Word usage, p. 300"
action:
name: replace
swap:
CRUD: create, retrieve, update, and delete (CRUD)
"I(?!/O)": you
he|she: you
host name: hostname
may: might (for possiblity)|can (for ability)
on-premises|on-prem|on premise: on-premise|on-site|in-house
entitlement: repository|subscription
plug-in: plugin
sane: accurate|valid|verified
tooling: tool|tools
via: through|by|from|on|by using
BIOS: firmware

View file

@ -1,152 +0,0 @@
---
extends: existence
ignorecase: true
level: suggestion
link: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/usage/
message: "Verify your use of '%s' with the word usage guidelines."
# source: "https://redhat-documentation.github.io/supplementary-style-guide/#glossary-terms-conventions; IBM - Appendix C. Word usage, p. 300"
tokens:
- "pop-up (?:help|menu)"
- "redbook(:s)?"
- above
- across
- actionable
- allow
- alpha
- alphabetic
- alphabetical
- architect
- architected
- as well as
- assembler
- attach
- below
- best-of-breed
- billion
- bitness
- black box
- board
- both
- bring up
- business partner
- cache
- carry out
- catch
- central processing unit
- check
- choose
- combination box
- combo box
- command console
- Common Base Event
- complete
- congratulations
- connect
- consumability
- consume
- could
- customers
- daughterboard
- decompress
- decompressed
- deploy
- designed to
- display
- domestic
- done
- either
- EPUB
- execute
- fatal
- foo
- foobar
- foreign
- free
- freeze
- fubar
- geography
- green screen
- guarantee
- hard boot
- hash
- hash sign
- higher
- hit
- hover help
- illegal
- impact
- info center
- infocenter
- information center
- ingest
- internationalize
- invoke
- itself
- Java Development Kit # IBM
- JDK #IBM
- kill
- latest
- legacy
- let
- like
- lite
- localize
- look and feel
- look-and-feel
- "(?<!virtual |Podman )machine(?! learning)"
- master and slave
- migrate
- native
- new
- once
- out-of-the-box
- overhead
- panel
- partner
- permit
- please
- pound sign
- program temporary fix
- proper
- pull-down
- quote
- quoted
- repair
- reside
- respective
- respectively
- sanity
- select
- selected
- should
- simply
- since
- slave
- so
- soft boot
- Solution Partnership Centers
- store
- tab
- text entry field
- text field
- themselves
- then
- there are
- there is
- this means
- throw
- throwable
- time to value
- time-tested
- translate
- trillion
- twistie
- twisty
- uncompressed
- unmount
- updatable
- very
- we
- whether or not
- while
- would

View file

@ -1,8 +0,0 @@
---
# source: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/userreplacedvalues/
extends: substitution
message: '%s, rather than %s'
level: suggestion
scope: raw
swap:
'__<[a-z_\x60]+-[\x60a-z_-]+>__': Separate words by underscores in user-replaced values

View file

@ -1,4 +0,0 @@
{
"feed": "https://github.com/redhat-documentation/vale-at-red-hat/releases.atom",
"vale_version": ">=2.20.0"
}

57
vale-json.tmpl Normal file
View file

@ -0,0 +1,57 @@
{{- /* Modify Vale's output https://docs.errata.ai/vale/cli#--output */ -}}
{{- /* Keep track of our various counts */ -}}
{{- $e := 0 -}}
{{- $w := 0 -}}
{{- $s := 0 -}}
{{- $f := 0 -}}
{{- /* Range over the linted files */ -}}
[
{{- range $jdx, $file := .Files -}}
{{- $f = add1 $f -}}
{{- $path := .Path -}}
{{- /* Range over the file's alerts */ -}}
{{- if $jdx -}},{{- end -}}
{{- range $idx, $a := .Alerts -}}
{{- $error := "" -}}
{{- if eq .Severity "error" -}}
{{- $error = "critical" -}}
{{- $e = add1 $e -}}
{{- else if eq .Severity "warning" -}}
{{- $error = "major" -}}
{{- $w = add1 $w -}}
{{- else -}}
{{- $error = "minor" -}}
{{- $s = add1 $s -}}
{{- end}}
{{- /* Variables setup */ -}}
{{- $loc := printf "%d" .Line -}}
{{- $check := printf "%s" .Check -}}
{{- $message := printf "%s" .Message -}}
{{- if $idx -}},{{- end -}}
{{- /* Output */ -}}
{
"description": "{{$check}}: {{ $message }}",
"fingerprint": "CI_COMMIT_SHA",
"severity": "{{ $error }}",
"location": {
"path": "{{ $path }}",
"lines": {
"begin": {{ $loc }}
}
}
}
{{end -}}
{{end -}}
]