diff --git a/.github/workflows/vale-docs-linter.yml b/.github/workflows/vale-docs-linter.yml
index f60909e..3e2aedb 100644
--- a/.github/workflows/vale-docs-linter.yml
+++ b/.github/workflows/vale-docs-linter.yml
@@ -18,7 +18,8 @@ jobs:
         with:
           fetch_depth: 2
           files: |
-            src/content/**/*.{md,mdx}
+            **/*.{md,mdx}
+            *.{md,mdx}
 
       # run reviewdog and the linter
       - name: run reviewdog and linter
diff --git a/.vale.ini b/.vale.ini
index 38b4323..a7945fc 100644
--- a/.vale.ini
+++ b/.vale.ini
@@ -1,3 +1,7 @@
+# styles/Fly and the fly-terms vocabulary are Fly's own and live here. The
+# three public packages are fetched by `vale sync`, pinned to the releases
+# below so a new upstream version cannot start enforcing rules we have not
+# looked at. superfly/docs uses the same pins.
 StylesPath = styles
 
 Vocab = fly-terms
@@ -6,9 +10,9 @@ MinAlertLevel = suggestion
 
 SkippedScopes = script
 
-Packages = proselint, write-good, Google
+Packages = https://github.com/vale-cli/Google/releases/download/v0.6.3/Google.zip, https://github.com/vale-cli/proselint/releases/download/v0.3.4/proselint.zip, https://github.com/vale-cli/write-good/releases/download/v0.4.1/write-good.zip
 
-[src/content/**/*.{mdx,md}]
+[*.{md,mdx}]
 BasedOnStyles = Fly, Google, proselint, Vale, write-good
 
 # Fly rules that we can turn back on when other things get cleaned up
@@ -18,6 +22,7 @@ Fly.Latin = NO
 Fly.Machine = NO # we can do an initial search and replace and then this rule will be less noisy and more useful
 Fly.OxfordComma = NO
 Fly.SentenceLength = NO # turn on later; then reduce further?
+Fly.Spelling = NO # off until the vocabulary covers these pages: 41 terms, all legitimate (Herdr, zsh, worktree, systemd)
 Fly.Us = NO
 
 # other style stuff turned off temporarily
diff --git a/styles/Fly/Exclamation.yml b/styles/Fly/Exclamation.yml
new file mode 100644
index 0000000..546bf95
--- /dev/null
+++ b/styles/Fly/Exclamation.yml
@@ -0,0 +1,8 @@
+extends: existence
+message: "Use exclamation points sparingly."
+nonword: true
+level: suggestion
+action:
+  name: remove
+tokens:
+  - '\w+!(?:\s|$)'
diff --git a/styles/Fly/Headings.yml b/styles/Fly/Headings.yml
new file mode 100644
index 0000000..3d32dee
--- /dev/null
+++ b/styles/Fly/Headings.yml
@@ -0,0 +1,28 @@
+extends: capitalization
+message: "'%s' should use sentence-style capitalization."
+level: suggestion
+scope: heading
+match: $sentence
+indicators:
+  - ':'
+exceptions:
+  - CLI
+  - Docker
+  - Elixir
+  - Fly
+  - Fly Proxy
+  - gRPC
+  - I
+  - Kubernetes
+  - Linux
+  - Machine
+  - Machines
+  - macOS
+  - MongoDB
+  - Nomad
+  - Rails
+  - Ruby
+  - REPL
+  - TypeScript
+  - URLs
+  - Windows
\ No newline at end of file
diff --git a/styles/Fly/Latin.yml b/styles/Fly/Latin.yml
new file mode 100644
index 0000000..8b88c61
--- /dev/null
+++ b/styles/Fly/Latin.yml
@@ -0,0 +1,13 @@
+extends: substitution
+message: "Use '%s' instead of '%s'."
+ignorecase: true
+level: suggestion
+nonword: true
+action:
+  name: replace
+swap:
+  '\b(?:eg|e\.g\.)(?=[\s,;])': for example
+  '\b(?:ie|i\.e\.)(?=[\s,;])': that is
+  '\b(?:viz\.)[\s,]': namely
+  '\b(?:ergo)[\s,]': therefore
+
diff --git a/styles/Fly/Machine.yml b/styles/Fly/Machine.yml
new file mode 100644
index 0000000..de846e6
--- /dev/null
+++ b/styles/Fly/Machine.yml
@@ -0,0 +1,12 @@
+  # This file tests some combinations of matches to try to avoid errors on proper usage.
+extends: substitution
+
+message: "Use '%s' instead of '%s'."
+
+level: suggestion
+
+swap:
+  '(?<!local|virtual) machine': Machine
+  '(?<!local|virtual) machines': Machines
+  '(?<=local|virtual) Machine': machine
+  '(?<=local|virtual) Machines': machines
diff --git a/styles/Fly/OxfordComma.yml b/styles/Fly/OxfordComma.yml
new file mode 100644
index 0000000..72b3e7e
--- /dev/null
+++ b/styles/Fly/OxfordComma.yml
@@ -0,0 +1,8 @@
+extends: existence
+message: "Use the Oxford comma in '%s'."
+link: https://docs.microsoft.com/en-us/style-guide/punctuation/commas
+scope: sentence
+level: suggestion
+nonword: true
+tokens:
+  - '(?:[^\s,]+,){1,} \w+ (?:and|or) \w+[.?!]'
\ No newline at end of file
diff --git a/styles/Fly/SentenceLength.yml b/styles/Fly/SentenceLength.yml
new file mode 100644
index 0000000..2f248e5
--- /dev/null
+++ b/styles/Fly/SentenceLength.yml
@@ -0,0 +1,7 @@
+# another experiment. sentences should probably be no more than about 30-35 words, but this rule counts underscored options as multiple words.
+extends: occurrence
+message: "Try to keep sentences short (< 40 words)."
+scope: sentence
+level: suggestion
+max: 40
+token: \b(\w+)\b
\ No newline at end of file
diff --git a/styles/Fly/Spelling.yml b/styles/Fly/Spelling.yml
new file mode 100644
index 0000000..32ce9d8
--- /dev/null
+++ b/styles/Fly/Spelling.yml
@@ -0,0 +1,23 @@
+extends: spelling
+message: "Is '%s' a typo?"
+level: suggestion
+
+# This disables the built-in filters. If you omit this
+# key or set it to false, custom filters (see below) are
+# added on top of the built-in ones.
+#
+# By default, filters for acronyms, abbreviations, and
+# numbers are included.
+custom: false
+
+# A "filter" is a regular expression specifying words
+# to ignore during spell checking.
+# custom Fly.io filters:
+filters:
+
+  - '\w+_\w+' # ignore config option names
+  - '--.' # ignore command options
+  - 'v[0.9].' # ignore flyctl versions
+
+ignore:
+  - words2ignore.txt
diff --git a/styles/Fly/Us.yml b/styles/Fly/Us.yml
new file mode 100644
index 0000000..5af8528
--- /dev/null
+++ b/styles/Fly/Us.yml
@@ -0,0 +1,11 @@
+extends: existence
+message: "Try to avoid using first-person plural like '%s'."
+link: 'https://developers.google.com/style/pronouns#personal-pronouns'
+level: suggestion
+ignorecase: true
+tokens:
+#  - we
+#  - we'(?:ve|re)
+#  - ours?
+  - us
+  - let's
diff --git a/styles/Fly/WordList.yml b/styles/Fly/WordList.yml
new file mode 100644
index 0000000..7f61828
--- /dev/null
+++ b/styles/Fly/WordList.yml
@@ -0,0 +1,43 @@
+extends: substitution
+message: "Consider using '%s' instead of '%s'."
+level: suggestion
+ignorecase: false
+action:
+  name: replace
+swap:
+  "(?:e-mail|E-mail)": email
+  "(?:file ?path|path ?name)": path
+  "(?:ok|Okay)": OK|okay
+  "(?:WiFi|wifi)": Wi-Fi
+  "un(?:check|select)": clear
+  # above: preceding
+  Ajax: AJAX
+  a\.k\.a|aka: or|also known as
+  # application: app
+  approx\.: approximately
+  # below: later|in the following steps
+  check box: checkbox
+  click on: click|click in
+  data are: data is
+  datatype: data type
+  datastore: data store
+  # filesystem: file system
+  firewalls: firewall rules
+  free tier: free allowances
+  functionality: capability|feature
+  healthcheck: health check
+  healthchecks: health checks
+  HTTPs: HTTPS
+  in order to: to
+  # instance: Machine
+  k8s: Kubernetes
+  leverage: use
+  Nodejs: Node.js
+  open-source: open source
+  SHA1: SHA-1|HAS-SHA1
+  sign into: sign in to
+  synch: sync
+  # url: URL
+  utilize: use
+  vs\.: versus
+  World Wide Web: web
diff --git a/styles/config/vocabularies/fly-terms/accept.txt b/styles/config/vocabularies/fly-terms/accept.txt
new file mode 100644
index 0000000..57e4392
--- /dev/null
+++ b/styles/config/vocabularies/fly-terms/accept.txt
@@ -0,0 +1,237 @@
+Alertmanager
+(?i)allowlist
+AMIs?\b
+Anycast
+APIs?\b
+(?i)Arcjet
+Astro
+[Aa]sync
+auditable
+autogenerated?\b
+automagically
+autosav\w+
+(?i)autostart\b
+(?i)autostop\b
+(?i)autosuspend\b
+backhaul
+backpressure
+bluegreen
+bool
+(?i)boolean
+[Bb]uildpacks?\b
+bursty
+callouts?\b
+centiseconds
+cgroup
+cgroups
+cleartext
+configs?\b
+containerd
+[Cc]ron(jobs?|job)?\b
+[Cc]rontabs?\b
+datacenters?\b
+Datadog
+datasource
+datatypes?\b
+declaratively
+(?i)dbs?\b
+discoverability
+Debian
+dedupe
+dev
+devs
+(?i)Dockerfile
+Dyno
+easycron
+[Ee]nqueues?\b
+enum
+(?i)env
+Escript
+Expr
+facto
+failover
+Fastify
+[Ff]ly.io
+Flycast
+flyctl
+flyd
+Flysystem
+fly.toml
+Gemfile
+geospatial
+GPUs?\b
+Grafana
+Gunicorn
+Hallpass
+HAProxy
+Hashicorp
+Hasura
+hellofly
+heredoc
+hostnames?\b
+Hotwire
+idempotently
+IEx
+incentivizes?\b
+initializer
+IP('s)?\b
+IPs
+IPSec
+ISPs?\b
+json
+JSON
+kcmartin
+kubeconfig
+kubectl
+Laravel
+libs
+LiteFS
+Litestream
+Livebook
+Logtail
+lsvd
+LSVD
+microVMs?\b
+middleware
+Midjourney
+Minecraft
+monorepo
+mothership
+MTUs?\b
+nameservers?\b
+namespaces?\b
+navbar
+nginx
+Nixpack
+NodeSource
+Nomad
+npm
+Nuxt
+NVIDIA
+NVMe
+OAuth
+Oban
+Ollama
+orgs?\b
+Paketo
+(?i)param(eter)?s?\b
+passthrough
+Paulo
+PCIe
+performant
+PGBouncer
+Phusion
+plaintext
+(?i)pooler
+PostgreSQL
+(?i)preauthorizations?\b
+precompile
+preconfigured?\b
+preload(ed)?\b
+(?i)prepend(ing)?
+Prisma
+(?i)procfiles?\b
+Prometheus
+proxying
+psql
+queryable
+reconnections
+repmgr
+repo
+Resque
+Rio de Janeiro
+rollout
+rootfs
+RTT
+[Rr]untimes?\b
+Ruygt
+SDKs?\b
+(?i)sequelize
+(?i)serverless
+Sidekiq
+signup
+SLAs?\b
+(?i)speedrun
+SQLAlchemy
+SSH
+stdin
+stdout
+subcommands?\b
+subfolders?\b
+subnets?\b
+subsecond
+Supabase
+Supercronic
+swapfile
+Symfony
+templated
+Terraform('s)?\b
+Tigris
+toolkits?\b
+tracebacks?\b
+Turboku
+uncomment
+unencrypted
+unlinked
+unlinking
+unmanaged
+unmount
+Upstash
+Valkey
+vCPUs?\b
+VM('s)?\b
+virtualized
+Vite
+VSCode
+Vue
+(?i)webpack
+walkthrough
+websockets?\b
+WireGuard
+Yaeger
+
+ams
+iad
+atl
+bhs
+bog
+bos
+otp
+maa
+ord
+dfw
+den
+eze
+fra
+gdl
+dev
+hkg
+jnb
+lhr
+lax
+mad
+mia
+yul
+bom
+cdg
+phx
+qro
+gig
+sjc
+scl
+gru
+sea
+ewr
+sin
+arn
+syd
+nrt
+yyz
+vin
+waw
+
+Ashburn
+Rio de Janeiro
+[Ss][ãa]o\b
+[Ss][ãa]o Paulo
+Secaucus
diff --git a/styles/config/vocabularies/fly-terms/reject.txt b/styles/config/vocabularies/fly-terms/reject.txt
new file mode 100644
index 0000000..1062e26
--- /dev/null
+++ b/styles/config/vocabularies/fly-terms/reject.txt
@@ -0,0 +1 @@
+(?i)healthcheck(s)
\ No newline at end of file
diff --git a/styles/words2ignore.txt b/styles/words2ignore.txt
new file mode 100644
index 0000000..98f35c6
--- /dev/null
+++ b/styles/words2ignore.txt
@@ -0,0 +1,32 @@
+args
+autoscale
+autoscaler
+autoscaling
+binstubs
+bundler
+chmod
+config
+const
+cpus
+deprioritize
+dockerfile-rails
+dockerignore
+healthcheck
+healthchecks
+heredocs
+IOPs
+nomad/v1
+num
+postgres
+sed
+subcommand
+svg
+toml
+v1
+v2
+vm
+vms
+http
+youtube
+shopify
+unavailabilty