Skip to content

Commit

Permalink
add a GitHub workflow to check syntax with Vale
Browse files Browse the repository at this point in the history
Also corrected some typos.
  • Loading branch information
fharper committed Dec 9, 2024
1 parent ad33012 commit b1482f1
Show file tree
Hide file tree
Showing 10 changed files with 329 additions and 3 deletions.
22 changes: 22 additions & 0 deletions .github/workflows/check-syntax.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
---
name: Check spelling & grammar
on: [push, workflow_dispatch]

jobs:
check-syntax:
name: vale
runs-on: ubuntu-latest
steps:

- name: Checkout this repository
uses: actions/[email protected]

- name: Install Vale
run: |
wget https://github.com/errata-ai/vale/releases/download/v3.7.0/vale_3.7.0_Linux_64-bit.tar.gz -O vale.tar.gz
tar -xvzf vale.tar.gz vale
rm vale.tar.gz
# Cannot run the action as reviewdog as an issue & don't fail on errors. See https://github.com/reviewdog/reviewdog/issues/1408
- name: Validate the syntax
run: ./vale --config=.vale.ini .
13 changes: 13 additions & 0 deletions .vale.ini
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
StylesPath = .vale
Vocab = base

[formats]
mdx = md

[*.md]
BasedOnStyles = Custom
Packages = alex
BlockIgnores = (?s) *(import.*?\n), \
(?s) *(### gitops\n), \
(?s) *(### Can I give the gitops repository another name\?\n)
TokenIgnores = (?s) *(export.*?\n)
Binary file added .vale/.DS_Store
Binary file not shown.
81 changes: 81 additions & 0 deletions .vale/Custom/ignore.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,81 @@
# A
argo
argocd
atlantis
aws

# B

# C
chartmuseum
civo
cli
Clusterception
composable
config
cronjob

# D

# E
ecr
eks
Entra

# F

# G
gcp
github
gitlab
gitops

# H
Hashicorp
https

# I
iam

# J

# K
kubeconfig
Kubefirst
kubernetes

# L

# M

# N

# O
oidc

# P

# Q

# R
repo

# S

# T
terraform

# U
ui
url

# V
vpc

# W

# X

# Y

# Z
6 changes: 6 additions & 0 deletions .vale/Custom/spelling.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
extends: spelling
message: "Did you really mean '%s'?"
level: error
ignore:
- .vale/Custom/ignore.txt
55 changes: 55 additions & 0 deletions .vale/Custom/substitutions.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
---
extends: substitution
message: Consider using '%s' instead of '%s'
ignorecase: false
level: error
swap:
# Starting or with a space before, and ending with a dot or space (so not working used in a path, caused of MDX)
'(?<=^| )argo [C|c][D|d](?=$| |\.)': Argo CD
# Starting or with a space before, and ending with a dot or space (so not working used in a path, caused of MDX)
'(?<=^| )Argo [C|c][D|d](?=$| |\.)': Argo CD
# Starting or with a space before, and ending with a dot or space (so not working used in a path, caused of MDX)
'(?<=^| )[A|a]rgo[C|c][D|d](?=$| |\.)': Argo CD
'argo [W|w]orkflows?': Argo Workflows
'Argo [W|w]orkflows?': Argo Workflows
atlantis: Atlantis
chartmuseum: ChartMuseum
cli: CLI
# Starting or with a space before, and ending with a dot or space (so not working used in a path, caused of MDX)
'(?<=^| )civo(?=$| |\.)': Civo
# Starting or with a space before, and ending with a dot or space (so not working used in a path, caused of MDX)
'(?<=^| )CIVO(?=$| |\.)': Civo
# Starting or with a space before, and ending with a dot or space (so not working used in a path, caused of MDX)
'(?<=^| )configs?(?=$| |\.)': configurations
cronjob: CronJob
ecr: ECR
eks: EKS
'digital[o|O]cean': DigitalOcean
'[d|D]igitalocean': DigitalOcean
docker: Docker
gcp: Google Cloud
gcp cloud: Google Cloud
'[G|g]ithub': GitHub
'git[H|h]ub': GitHub
'[G|g]itlab': GitLab
'git[L|l]ab': GitLab
'(?<=^| )gitops(?=$| |\.)': GitOps for the term or put gitops as inline code for the repository
google: Google
Hashicorp: HashiCorp
helm: Helm
https: HTTPS
iam: IAM
konstruct: Konstruct
# kubefirst: Kubefirst
kubernetes: Kubernetes
mongo: MongoDB
oidc: OIDC
repo: repository
SSH: SSH
# Starting or with a space before, and ending with a dot or space (so not working used in a path, caused of MDX)
'(?<=^| )terraform(?=$| |\.)': Terraform
ui: UI
url: URL
vault: Vault
vpc: VPC
vultr: Vultr
149 changes: 149 additions & 0 deletions .vale/config/vocabularies/base/accept.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,149 @@
# A
Adedeji
admunition
Akamai
Allin
anonymize
Appsmith
Apress
auditable
authentification
authtoken
automation

# B
Bangser
Blanco
Botkube

# C
CLI'
CLIs
ClusterIssuer
Codezero
cofounder
containerd
CPU
Crossplane
CWFT

# D
Datadog
deprovision
Devrel
devrelshow
Dietz
Dockerfile
Docusaurus

# E
Emms

# F
Fitbit

# G
Gamov
Gitpod
Gottfried
Gradle

# H
Haimantika
hardcoded
Hashnode
Heilmann
hotfix

# I
IDPs
Ikechukwu
interoperate
Iyengar

# J

# K
kbot
KMS
Konstruct
Kratix
kubectl
Kubefirst
Kubeshop
Kyverno

# L
liblab
Linode
livestream
Livestreams

# M
markdownlint
Mikail
mkcert
multinode

# N
namespace
nerdctl
npm
ngrok
Nginx

# O
onboarding
Otterize

# P
preconfigure
preloaded

# Q

# R
Rejekts
Reloader
Rizel
routable

# S
Sadogursky
Scarlett
Seqera
Sillars
Smallstep
Specsavers
statestore
subnet

# T
teardown
Testkube
Tobiloba
todo
toolset
Tracetest
Traefik
truststore
Typesense

# U
uncomment

# V
vale
vcluster
Viktor
Vonage
Vultr

# W
walkthrough

# X

# Y

# Z
2 changes: 1 addition & 1 deletion speakers/fred.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ Fred gave 190 talks in 23 different countries. You can find the full list, inclu
- Breaking the Silos - [GitOps Strategies through Kubefirst](https://www.youtube.com/live/om1rxvKJe3M) (November 4)
- The devrelshow with Fred - [episode 4 with Mason Egger from Temporal](https://www.youtube.com/watch?v=fd8v15-11Ic) (November 2)
- Kubefirst Live - [kubefirst 2.3: physical & virtual workload clusters](https://www.youtube.com/watch?v=KAo3KPYjQ98) (October 26)
- The devrelshow with Fred - [episode 3 with David G. Simmons from Otterize](https://www.youtube.com/watch?v=sQvimBNlvSY) (OCtober 16)
- The devrelshow with Fred - [episode 3 with David G. Simmons from Otterize](https://www.youtube.com/watch?v=sQvimBNlvSY) (October 16)
- GitHub - [Open Source Friday with Kubefirst](https://www.youtube.com/live/FEmb12t6i6Y) (October 13)
- Kubefirst Live - [Kyverno: a policy engine designed for Kubernetes](https://www.youtube.com/watch?v=hsf58XJD3j4) (October 12)
- The devrelshow with Fred - [episode 2 with Alejandra Thomas](https://www.youtube.com/watch?v=lq4UHTJ4yEY) (October 4)
Expand Down
2 changes: 1 addition & 1 deletion speakers/jared.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ Jared has spent the last 6 years focused exclusively on introducing Kubernetes t
- Kubefirst Live - [Argo CD Best Practices & Practical Patterns](https://www.youtube.com/watch?v=CJQBtDYA_44) (February 2 2023)
- Kubefirst Live - [kubefirst v1.11 Release: Local update, Improved Vault support](https://www.youtube.com/watch?v=dnb8PkstC0Y) (January 19 2023)
- Kubefirst Live - [kubefirst v1.10 release & other awesomeness](https://www.youtube.com/watch?v=cjbWbyWCI4Q) (December 13 2022)
- Kubefirst Live -[kubefirst v1.9 Release: Github, Hashicorp Vault and Admin Console](https://www.youtube.com/watch?v=6OwLwN_G9D0) (October 11 2022)
- Kubefirst Live -[kubefirst v1.9 Release: GitHub, HashiCorp Vault and Admin Console](https://www.youtube.com/watch?v=6OwLwN_G9D0) (October 11 2022)
- Kubefirst Live -[kubefirst 1.8 Release](https://www.youtube.com/watch?v=2sFdz21JQ7c) (July 26 2022)

## Expertise
Expand Down
2 changes: 1 addition & 1 deletion speakers/john.md
Original file line number Diff line number Diff line change
Expand Up @@ -80,7 +80,7 @@ John has been at the forefront of Kubernetes adoption since 2017 and has assiste
#### 2022

- Kubefirst Live -[kubefirst v1.10 release & other awesomeness](https://www.youtube.com/watch?v=cjbWbyWCI4Q) (December 13)
- Kubefirst Live -[kubefirst v1.9 Release: Github, Hashicorp Vault and Admin Console](https://www.youtube.com/watch?v=6OwLwN_G9D0) (October 11)
- Kubefirst Live -[kubefirst v1.9 Release: GitHub, HashiCorp Vault and Admin Console](https://www.youtube.com/watch?v=6OwLwN_G9D0) (October 11)
- Kubefirst Live -[kubefirst 1.8 Release](https://www.youtube.com/watch?v=2sFdz21JQ7c) (July 26)

### Videos
Expand Down

0 comments on commit b1482f1

Please sign in to comment.