Skip to content

Commit

Permalink
Merge pull request #9 from JoshuaKGoldberg/mention-all-contributors-a…
Browse files Browse the repository at this point in the history
…uto-action

docs: mention all-contributors-auto-action in README.md
  • Loading branch information
JoshuaKGoldberg committed May 9, 2023
2 parents f72cb48 + b2a3a64 commit dc0c0e7
Show file tree
Hide file tree
Showing 9 changed files with 1,258 additions and 1,189 deletions.
17 changes: 15 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,12 @@
<img alt="TypeScript: Strict" src="https://img.shields.io/badge/typescript-strict-21bb42.svg" />
</p>

<p align="center">
<em>
✨ See this tool in action with <a href="https://github.com/JoshuaKGoldberg/all-contributors-auto-action">all-contributors-auto-action</a>! ✨
</em>
</p>

## Usage

```shell
Expand All @@ -51,15 +57,22 @@ const contributors = await createAllContributorsForRepository({
> This tool only sees contributions that can be detected from the last 500 events in GitHub's API.
> Don't forget to manually add in other forms of contributions!
The types of contributions detected are:
The types of contributions detected from the GitHub API are:

- 🐛 `bug`: anybody who filed an issue labeled as accepting PRs and a bug _(see options)_
- 💻 `computer`: all PR authors and co-authors
- 💻 `code`: all PR authors and co-authors
- 📖 `doc`: authors of merged PRs that address issues labeled as accepting PRs and docs _(see options)_
- 🚧 `maintenance`: adding labels to issues and PRs, and merging PRs
- 👀 `review`: submitting a review for a PR
- 🔧 `tool`: authors of merged PRs that address issues labeled as accepting PRs and tooling _(see options)_

Additionally, based on PR [conventional commit titles](https://www.conventionalcommits.org/en/v1.0.0/#summary) in the [Angular convention](https://github.com/angular/angular/blob/22b96b9/CONTRIBUTING.md#type):

- `build` and `ci`: will be treated as an `:infra:` contribution
- `docs`: will be treated as an `:doc:` contribution
- `test`: will be treated as an `:test:` contribution
- All other PRs -including those without a conventional title- will be treated as `:code:` contributions

> 💡 Given that list of contributors, you might want to run `all-contributors add` on each contributor & contribution type.
>
> ```ts
Expand Down
2 changes: 2 additions & 0 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -34,9 +34,11 @@
"*": "prettier --ignore-unknown --write"
},
"dependencies": {
"conventional-commits-parser": "^3.2.4",
"octokit": "^2.0.14"
},
"devDependencies": {
"@types/conventional-commits-parser": "^3.0.3",
"@types/eslint": "^8.21.1",
"@typescript-eslint/eslint-plugin": "^5.48.2",
"@typescript-eslint/parser": "^5.48.2",
Expand Down
Loading

0 comments on commit dc0c0e7

Please sign in to comment.