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

Update README.md #31

Merged
merged 2 commits into from
Jan 3, 2023
Merged

Update README.md #31

merged 2 commits into from
Jan 3, 2023

Conversation

khiga8
Copy link
Contributor

@khiga8 khiga8 commented Dec 29, 2022

Fixes: #29

Adds instructions for configuring formatter which will ensure error messages include link to rule documentation (which doesn't happen by default).

Also does minor clean-up.

@khiga8 khiga8 requested a review from a team as a code owner December 29, 2022 18:08
@accessibility-bot
Copy link
Collaborator

👋 Hello and thanks for pinging us! An accessibility first responder will review this soon.

  • 💻 On PRs for our review: please provide a review environment with steps to validate, screenshots (with alt text), or videos (with description following) demonstrating functionality we should be checking. This will help speed up our review and feedback cycle.
  • ⚠️ If this is urgent, please visit us in #accessibility on Slack and tag the first responder(s) listed in the channel topic.

In addition to defaults defined by `markdownlint`, we use this repository to enforce rules not defined by default, including our own custom rules.

See our opinions codified in [index.js](./index.js).

### Should I disable rules enabled by this plugin?
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Moving this down after the setup where it makes more sense.


## Opinions

At GitHub, we have opinions about how our markdown should be written.
Copy link
Contributor Author

Choose a reason for hiding this comment

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

This seemed redundant so removing.

Comment on lines -3 to -5
We are using the [`markdownlint`](https://github.com/DavidAnson/markdownlint) library (via [`markdownlint-cli2`](https://github.com/DavidAnson/markdownlint-cli2) and adding our opinions and custom rules to it.

To review behaviors supported by `markdownlint`, particularly how to enable or disable rules, see [`markdownlint-cli2` configuration](https://github.com/DavidAnson/markdownlint-cli2#configuration).
Copy link
Contributor Author

Choose a reason for hiding this comment

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

I moved portions of this down into the setup section.

Copy link
Contributor

@lindseywild lindseywild left a comment

Choose a reason for hiding this comment

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

🎉

README.md Outdated Show resolved Hide resolved
Co-authored-by: Lindsey Wild <35239154+lindseywild@users.noreply.github.com>
@khiga8 khiga8 merged commit c1029f6 into main Jan 3, 2023
@khiga8 khiga8 deleted the kh-update-readme branch January 3, 2023 14:33
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.

Default error output does not include link to documentation
3 participants