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 CONTRIBUTING.md to solicit contributions #846

Merged
merged 1 commit into from Apr 15, 2022

Conversation

uncommon-type
Copy link
Contributor

@uncommon-type uncommon-type commented Apr 3, 2022

Description

This PR adds a CONTRIBUTING.md file to provide potential contributors with a short guide on how to help with the project. It explains the ways to get involved as well as gives setup/installation details and information on how to submit Pull Requests.

Related Issue

Closes #845

Acceptance Criteria

  • Info is included on ways to contribute
  • Details are provided on how to set up dev environment
  • Guidelines are given on how to submits pull requests
  • Table of contents is added with links to document headings

Type of Changes

Type
πŸ› Bug fix
✨ New feature
πŸ”¨ Refactoring
πŸ’― Add tests
πŸ”— Update dependencies
βœ“ πŸ“œ Docs

@codecov
Copy link

codecov bot commented Apr 3, 2022

Codecov Report

Merging #846 (b7d1e58) into main (ce2c328) will increase coverage by 0.00%.
The diff coverage is n/a.

❗ Current head b7d1e58 differs from pull request most recent head ee933a2. Consider uploading reports for the commit ee933a2 to get more accurate results

@@           Coverage Diff           @@
##             main     #846   +/-   ##
=======================================
  Coverage   99.25%   99.25%           
=======================================
  Files          98       99    +1     
  Lines        1474     1476    +2     
  Branches      482      482           
=======================================
+ Hits         1463     1465    +2     
  Misses         11       11           
Impacted Files Coverage Ξ”
src/util/implicitRoles/dl.js 100.00% <0.00%> (ΓΈ)

Continue to review full report at Codecov.

Legend - Click here to learn more
Ξ” = absolute <relative> (impact), ΓΈ = not affected, ? = missing data
Powered by Codecov. Last update ce2c328...ee933a2. Read the comment docs.

CONTRIBUTING.md Outdated

#### Resolving existing issues

You can consider helping out with [issues](https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/issues) already requiring attention.
Copy link
Member

Choose a reason for hiding this comment

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

should this link to the "help wanted" label?

CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Outdated

> **Note:** Before submitting an issue, please check open and closed issues to see if the problem has already been reported.

If you want to propose a new rule, please follow these [instructions](https://eslint.org/docs/developer-guide/contributing/new-rules).
Copy link
Member

Choose a reason for hiding this comment

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

these are eslint core's guidelines - probably worth folks reading, but not necessarily the criteria we'd apply here.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

thank you for letting me know, I removed this sentenceπŸ˜„

CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Outdated
Comment on lines 121 to 131
* `fix` for a bug fix
* `feat` either for a backwards-compatible enhancement or for a rule change that adds reported problems
* `fix!` for a backwards-incompatible bug fix
* `feat!` for a backwards-incompatible enhancement or feature
* `docs` for changes to documentation only
* `chore` for changes that aren't user-facing
* `build` for changes to build process only
* `refactor` a change that doesn't affect APIs or user experience
* `test` just changes to test files
* `ci` changes to our CI configuration files and scripts
* `perf` a code change that improves performance
Copy link
Member

Choose a reason for hiding this comment

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

these are angular's/conventional-commit's commit message conventions, and i don't use them. in particular, i'm philosophically opposed to "chore" - chores are bad, repo maintenance is good.

my commit conventions are undocumented but somewhat consistent. i suppose i should probably document them in a gist, and then we can link to that here.

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've seen those listed on the ESLint website, this is why I've included them hereπŸ˜„. Will remove them for now and wait for your gist.

CONTRIBUTING.md Outdated

## Code of Conduct

We adhere to the [OpenJS Foundation Code of Conduct](https://github.com/openjs-foundation/cross-project-council/blob/main/CODE_OF_CONDUCT.md) and expect
Copy link
Member

Choose a reason for hiding this comment

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

this is a great idea, but we don't actually adhere to that in this github org yet. we could add a CODE_OF_CONDUCT.md file to https://github.com/jsx-eslint/.github, though, and then we don't need to mention it here at all.

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 din't know - I've taken this reference from the ESLlint website, will remove it, thank you for pointing it out πŸ˜„

@ljharb ljharb marked this pull request as draft April 7, 2022 05:07
@ljharb
Copy link
Member

ljharb commented Apr 7, 2022

This is pending jsx-eslint/.github#1.

@uncommon-type uncommon-type force-pushed the add-contributor-guidelines branch 3 times, most recently from b7d1e58 to cfbb069 Compare April 15, 2022 12:03
@uncommon-type uncommon-type marked this pull request as ready for review April 15, 2022 12:05
Copy link
Member

@ljharb ljharb left a comment

Choose a reason for hiding this comment

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

Thanks!

@ljharb ljharb force-pushed the add-contributor-guidelines branch from cfbb069 to ee933a2 Compare April 15, 2022 16:46
@ljharb ljharb merged commit ee933a2 into jsx-eslint:main Apr 15, 2022
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.

Add CONTRIBUTING.md to provide others with a short guide to how they can help with the project
2 participants