Skip to content

docs/vale-styles: Bump all style violations to "error" level so they fail CI#8940

Merged
issyl0 merged 3 commits intoHomebrew:masterfrom
issyl0:fix-vale
Oct 21, 2020
Merged

docs/vale-styles: Bump all style violations to "error" level so they fail CI#8940
issyl0 merged 3 commits intoHomebrew:masterfrom
issyl0:fix-vale

Conversation

@issyl0
Copy link
Copy Markdown
Member

@issyl0 issyl0 commented Oct 17, 2020

  • Have you followed the guidelines in our Contributing document?
  • Have you checked to ensure there aren't other open Pull Requests for the same change?
  • Have you added an explanation of what your changes do and why you'd like us to include them?
  • Have you written new tests for your changes? Here's an example.
  • Have you successfully run brew style with your changes locally?
  • Have you successfully run brew tests with your changes locally?
  • Have you successfully run brew man locally and committed any changes?

  • I added these all the way back in December 2019 in Add Vale linting for our docs #6826, but only today (thanks to my Sorbet PR) realised that things have been failing unnoticeably because "warning" level exits with status code 0, so doesn't fail CI.
  • Upgrading to "error" level will enable us to see the style errors in our docs in every CI run and fix them faster.
  • My editor also auto-formatted the YAML to have double quotes instead of single. And I fixed all the remaining style failures, now I can see them!

@issyl0
Copy link
Copy Markdown
Member Author

issyl0 commented Oct 17, 2020

I've attempted an upstream PR to fix (hopefully) the errors we're seeing with not being able to use / in capitalization exclusions any more.

On the upside, at least these "style failures" fail the CI build now!

@Rylan12
Copy link
Copy Markdown
Member

Rylan12 commented Oct 19, 2020

Good catch! Should the rules for oxford commas and pronouns be upgraded to errors as well?

@MikeMcQuaid
Copy link
Copy Markdown
Member

Thanks @issyl0!

Good catch! Should the rules for oxford commas and pronouns be upgraded to errors as well?

Agreed. I don't personally see the point in any non-error rules as they will be ignored and the warnings be confusing when an actual error occurs.

@issyl0
Copy link
Copy Markdown
Member Author

issyl0 commented Oct 19, 2020

Should the rules for oxford commas and pronouns be upgraded to errors as well?

Good catch, that was an oversight rather than a deliberate choice. Done now, everything is at "error" level.

- Otherwise this surfaces an error and suggests a fix that doesn't match
  Apple's branding.
- I added these all the way back in December 2019 in #6826, but only
  today realised that things have been failing unnoticeably because
  "warning" level exits with status code 0, so doesn't fail CI.
- Upgrading to "error" level will enable us to see the style errors in
  our docs and fix them faster.
- My editor also auto-formatted the YAML to have double quotes instead
  of single.
- I don't necessarily agree with this, but it's AP style that words with
  four or more letters should start with a capital when in titles.
@issyl0 issyl0 merged commit 5efa3d6 into Homebrew:master Oct 21, 2020
@issyl0 issyl0 deleted the fix-vale branch October 21, 2020 21:09
@BrewTestBot BrewTestBot added the outdated PR was locked due to age label Dec 1, 2020
@Homebrew Homebrew locked as resolved and limited conversation to collaborators Dec 1, 2020
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

outdated PR was locked due to age

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants