Skip to content

Vale linting — fix existing warnings and enforce in CI #8

Description

@kristopherjturner

Summary

Currently Vale runs with continue-on-error: true across all repos because existing docs have spelling/style warnings. Clean up the warnings and enforce Vale strictly.

Tasks

  • Run vale docs/ locally on each repo and catalog all warnings
  • Fix legitimate issues (spelling, style, passive voice, etc.)
  • Add false positives to .vale/styles/config/vocabularies/ accept lists (technical terms like VMs, FSLogix, SOFS, Bicep, etc.)
  • Remove continue-on-error: true from all deploy-docs.yml workflows
  • Verify all repos pass Vale strict mode in CI

Repos

  • azurelocal.github.io
  • azurelocal-sofs-fslogix
  • aurelocal-avd
  • azurelocal-loadtools
  • azurelocal-vm-conversion-toolkit

Activity

  1. kristopherjturner commented on Mar 16, 2026

    @kristopherjturner
    ContributorAuthor

    🔗 Related: #12 (azurelocal-toolkit migration) will include Vale linting setup (styles/Microsoft/) for the new azurelocal-toolkit repo, following the same standard.

  2. kristopherjturner commented on Mar 18, 2026

    @kristopherjturner
    ContributorAuthor

    Linked to Epic #24. Vale linting enforcement depends on clean standards content.

  3. kristopherjturner commented on May 10, 2026

    @kristopherjturner
    ContributorAuthor
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions