Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add a linter to require RFC-2119 keywords are capitalized #77

Open
kdenhartog opened this issue Jun 7, 2023 · 2 comments
Open

Add a linter to require RFC-2119 keywords are capitalized #77

kdenhartog opened this issue Jun 7, 2023 · 2 comments
Labels
in discussion Feature is still in discussion and should not be implemented

Comments

@kdenhartog
Copy link
Contributor

This isn't a necessity, but it would be nice if the linter called out when keywords are used and forced capitalization of them. This can be useful for readers to understand when the reader intentionally wants a piece of text to be a normative statement (required for conformance to the spec) versus when the author is accidentally reusing a normative word and should update the text so that it's more clear this isn't required.

@SamWilsn SamWilsn added the in discussion Feature is still in discussion and should not be implemented label Jun 28, 2023
@SamWilsn
Copy link
Collaborator

So the two rules could be:

  • Error if capitalized keywords appear outside of the specification section.
  • Warn if a non-capitalized keyword appears inside the specification section.

Sound reasonable?

@kdenhartog
Copy link
Contributor Author

That would be ideal. I'd be alright with warn for both as well based on the amount of complaints about linter being overly strict.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
in discussion Feature is still in discussion and should not be implemented
Projects
None yet
Development

No branches or pull requests

2 participants