Skip to content

chore: add Vale prose-linting config - #259

Open
iabaako wants to merge 1 commit into
mainfrom
chore/add-vale-config
Open

chore: add Vale prose-linting config#259
iabaako wants to merge 1 commit into
mainfrom
chore/add-vale-config

Conversation

@iabaako

@iabaako iabaako commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Adds .vale.ini configuring the Microsoft and IPA style packages for markdown/quarto docs, per IPA's writing guidelines.

Test plan

  • File reviewed for sensitive content (none present)
  • Pre-commit hooks pass

🤖 Generated with Claude Code

Adds .vale.ini configuring the Microsoft and IPA style packages for
markdown/quarto docs, per IPA's writing guidelines.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@iabaako
iabaako requested a review from a team as a code owner August 5, 2026 14:35
Copilot AI review requested due to automatic review settings August 5, 2026 14:35
@sonarqubecloud

sonarqubecloud Bot commented Aug 5, 2026

Copy link
Copy Markdown

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds a Vale configuration file to enable prose linting for Markdown/Quarto documentation using the Microsoft style package and intended IPA guidelines.

Changes:

  • Adds .vale.ini with a configured StylesPath, MinAlertLevel, and Markdown/Quarto format association.
  • Enables Microsoft styles and configures per-format style application and rule overrides.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread .vale.ini
@@ -0,0 +1,40 @@
# docs: https://vale.sh/docs/topics/config/
StylesPath = assets/writing-styles
Comment thread .vale.ini
Comment on lines +6 to +15
Packages = Microsoft

[formats]
# Format associations appear under
# the optional "formats" section.
qmd = md

# docs: IPA Writing Guidelines https://ipastorage.box.com/shared/static/exej2k7pzsr9clr9hxdie70zaiv78j2k.docx
[*.{md,qmd}]
BasedOnStyles = IPA, Microsoft
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants