Need more than a rule playground?

Explore Vale CMS
Package Explorer

Microsoft

A Vale-compatible implementation of the Microsoft Writing Style Guide.

Source style

Getting started

Add it to your .vale.ini, then run vale sync.

Packages = Microsoft

[*.md]
BasedOnStyles = Vale, Microsoft

Rules 40

20 error10 warning10 suggestion
  • Microsoft.Accessibility suggestion existence Style guide

    Don't use language (such as '%s') that defines people by their disability.

  • Microsoft.Acronyms suggestion conditional Style guide

    '%s' has no definition.

  • Microsoft.Adverbs warning existence Style guide

    Remove '%s' if it's not important to the meaning of the statement.

  • Microsoft.AMPM error existence Style guide

    Use 'AM' or 'PM' (preceded by a space).

  • Microsoft.Auto error existence Style guide

    In general, don't hyphenate '%s'.

  • Microsoft.Avoid error existence Style guide

    Don't use '%s'. See the A-Z word list for details.

  • Microsoft.Contractions error substitution Style guide

    Use '%s' instead of '%s'.

  • Microsoft.Dashes error existence Style guide

    Remove the spaces around '%s'.

  • Microsoft.DateFormat error existence Style guide

    Use 'July 31, 2016' format, not '%s'.

  • Microsoft.DateNumbers error existence Style guide

    Don't use ordinal numbers for dates.

  • Microsoft.DateOrder error existence Style guide

    Always spell out the name of the month.

  • Microsoft.Ellipses warning existence Style guide

    In general, don't use an ellipsis.

  • Microsoft.FirstPerson warning existence Style guide

    Use first person (such as '%s') sparingly.

  • Microsoft.Foreign error substitution Style guide

    Use '%s' instead of '%s'.

  • Microsoft.Gender error existence Style guide

    Don't use '%s'.

  • Microsoft.GenderBias error substitution

    Consider using '%s' instead of '%s'.

  • Microsoft.GeneralURL warning existence Style guide

    For a general audience, use 'address' rather than 'URL'.

  • Microsoft.HeadingAcronyms warning existence scope: heading Style guide

    Avoid using acronyms in a title or heading.

  • Microsoft.HeadingColons error existence scope: heading Style guide

    Capitalize '%s'.

  • Microsoft.HeadingPunctuation warning existence scope: heading Style guide

    Don't use end punctuation in headings.

  • Microsoft.Headings suggestion capitalization scope: heading Style guide

    '%s' should use sentence-style capitalization.

  • Microsoft.Hyphens warning existence Style guide

    '%s' doesn't need a hyphen.

  • Microsoft.Negative error existence Style guide

    Form a negative number with an en dash, not a hyphen.

  • Microsoft.Ordinal error existence Style guide

    Don't add -ly to an ordinal number.

  • Microsoft.OxfordComma suggestion existence scope: sentence Style guide

    Use the Oxford comma in '%s'.

  • Microsoft.Passive suggestion existence

    '%s' looks like passive voice.

  • Microsoft.Percentages error existence Style guide

    Use a numeral plus the units.

  • Microsoft.Plurals error existence Style guide

    Don't add '%s' to a singular noun. Use plural instead.

  • Microsoft.Quotes error existence Style guide

    Punctuation should be inside the quotes.

  • Microsoft.RangeTime error existence Style guide

    Use 'to' instead of a dash in '%s'.

  • Microsoft.Semicolon suggestion existence scope: sentence Style guide

    Try to simplify this sentence.

  • Microsoft.SentenceLength suggestion occurrence scope: sentence

    Try to keep sentences short (< 30 words).

  • Microsoft.Spacing error existence Style guide

    '%s' should have one space.

  • Microsoft.Suspended warning existence Style guide

    Don't use '%s' unless space is limited.

  • Microsoft.Terms warning substitution Style guide

    Prefer '%s' over '%s'.

  • Microsoft.Units error existence Style guide

    Don't spell out the number in '%s'.

  • Microsoft.URLFormat suggestion substitution Style guide

    Use 'of' (not 'for') to describe the relationship of the word URL to a resource.

  • Microsoft.Vocab suggestion existence Style guide

    Verify your use of '%s' with the A-Z word list.

  • Microsoft.We warning existence Style guide

    Try to avoid using first-person plural like '%s'.

  • Microsoft.Wordiness suggestion substitution Style guide

    Consider using '%s' instead of '%s'.