fix: restore Coder-specific Vale style rules

EdwardAngert · claude · EdwardAngert · commit 90ae6b551d0d · 2025-04-23T03:40:56.000-04:00
Restore Coder-specific Vale style rules that were missing: 1. Add Coder.Headings for title case with technical term exceptions 2. Add Coder.Terms for consistent terminology 3. Add Coder.SentenceLength for documentation readability 4. Update Vale configuration to use Coder style rules 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
diff --git a/.github/docs/vale/.vale.ini b/.github/docs/vale/.vale.ini
@@ -1,20 +1,22 @@
-# Vale configuration file for Coder docs
-StylesPath = styles
+# Vale configuration file for Coder documentation
+# Based on Google and GitLab style guides with additional linters
 
-# Minimum alert level
-# "suggestion", "warning", or "error"
+StylesPath = styles
 MinAlertLevel = warning
 
+# External packages - commented out as they need to be installed
+# Packages = Google, write-good, proselint, alex, readability
+
 # Global configuration
 [*]
 # List of styles to use
-BasedOnStyles = Vale
+BasedOnStyles = Vale, Coder
 
 # Ignore code blocks
 BlockIgnores = (?s)```(.|\n)*?```
-
-# Ignore inline code
-TokenIgnores = (\`[^\`]*?\`)
+BlockIgnores = (?s){{<[^>]*>}}(.|\n)*?{{</[^>]*>}}
+BlockIgnores = (?s)`[^`\n]+`  # Inline code
+BlockIgnores = (?s)^\s*---\n.*?\n---\n  # YAML frontmatter
 
 # Vale style rules
 Vale.Spelling = NO
@@ -23,4 +25,13 @@ Vale.Terms = YES
 # Additional style rules
 [*.md]
 # Markdown-specific configuration
-BasedOnStyles = Vale
+BasedOnStyles = Vale, Coder
+
+# Rule-specific configuration
+Coder.Headings = warning
+Coder.Terms = warning
+Coder.SentenceLength = suggestion
+
+# Exclude auto-generated documentation
+[docs/reference/*.md]
+BasedOnStyles = NO
diff --git a/.github/docs/vale/styles/Coder/Headings.yml b/.github/docs/vale/styles/Coder/Headings.yml
@@ -23,14 +23,4 @@ exceptions:
   - Terraform
   - kubectl
   - Helm
-  - GitHub
-  - GitLab
-  - OAuth
-  - OIDC
-  - SSH
-  - Git
-  - npm
-  - Node.js
-  - dev container
-  - dev containers
-  - dev environment
+  - GitHub
