doc: mention git-node in the collaborator guide

PR-URL: https://github.com/nodejs/node/pull/18960
Fixes: https://github.com/nodejs/node/issues/18197
Reviewed-By: Michaël Zasso <targos@protonmail.com>
Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Vse Mozhet Byt <vsemozhetbyt@gmail.com>
Reviewed-By: Weijia Wang <starkwang@126.com>
Reviewed-By: Matheus Marchini <matheus@sthima.com>
Reviewed-By: Shingo Inoue <leko.noor@gmail.com>
This commit is contained in:
Joyee Cheung 2018-02-23 21:53:35 +08:00 committed by Benjamin Gruenbaum
parent 1460b31bd3
commit 1bb92ce04f

View File

@ -21,6 +21,7 @@
- [Deprecations](#deprecations) - [Deprecations](#deprecations)
- [Involving the TSC](#involving-the-tsc) - [Involving the TSC](#involving-the-tsc)
* [Landing Pull Requests](#landing-pull-requests) * [Landing Pull Requests](#landing-pull-requests)
- [Using `git-node`](#using-git-node)
- [Technical HOWTO](#technical-howto) - [Technical HOWTO](#technical-howto)
- [Troubleshooting](#troubleshooting) - [Troubleshooting](#troubleshooting)
- [I Just Made a Mistake](#i-just-made-a-mistake) - [I Just Made a Mistake](#i-just-made-a-mistake)
@ -455,6 +456,26 @@ Additionally:
- All commits should be self-contained (meaning every commit should pass all - All commits should be self-contained (meaning every commit should pass all
tests). This makes it much easier when bisecting to find a breaking change. tests). This makes it much easier when bisecting to find a breaking change.
### Using `git-node`
In most cases, using [the `git-node` command][git-node] of [`node-core-utils`][]
should be enough to help you land a Pull Request. If you discover a problem when
using this tool, please file an issue
[to the issue tracker][node-core-utils-issues].
Quick example:
```text
$ npm install -g node-core-utils
$ git node land $PRID
```
If it's the first time you ever use `node-core-utils`, you will be prompted
to type the password of your GitHub account in the console so the tool can
create the GitHub access token for you. If you do not want to do that, follow
[the guide of `node-core-utils`][node-core-utils-credentials]
to set up your credentials manually.
### Technical HOWTO ### Technical HOWTO
Clear any `am`/`rebase` that may already be underway: Clear any `am`/`rebase` that may already be underway:
@ -571,7 +592,8 @@ commit logs, ensure that they are properly formatted, and add
<a name="metadata"></a> <a name="metadata"></a>
* Modify the original commit message to include additional metadata regarding * Modify the original commit message to include additional metadata regarding
the change process. ([`node-core-utils`][] fetches the metadata for you.) the change process. (The [`git node metadata`][git-node-metadata] command
can generate the metadata for you.)
* Required: A `PR-URL:` line that references the *full* GitHub URL of the * Required: A `PR-URL:` line that references the *full* GitHub URL of the
original pull request being merged so it's easy to trace a commit back to original pull request being merged so it's easy to trace a commit back to
@ -750,6 +772,10 @@ LTS working group and the Release team.
[Stability Index]: doc/api/documentation.md#stability-index [Stability Index]: doc/api/documentation.md#stability-index
[Enhancement Proposal]: https://github.com/nodejs/node-eps [Enhancement Proposal]: https://github.com/nodejs/node-eps
[`--pending-deprecation`]: doc/api/cli.md#--pending-deprecation [`--pending-deprecation`]: doc/api/cli.md#--pending-deprecation
[git-node]: https://github.com/nodejs/node-core-utils/blob/master/docs/git-node.md
[git-node-metadata]: https://github.com/nodejs/node-core-utils/blob/master/docs/git-node.md#git-node-metadata
[git-username]: https://help.github.com/articles/setting-your-username-in-git/ [git-username]: https://help.github.com/articles/setting-your-username-in-git/
[`node-core-utils`]: https://github.com/nodejs/node-core-utils [`node-core-utils`]: https://github.com/nodejs/node-core-utils
[TSC]: https://github.com/nodejs/TSC [TSC]: https://github.com/nodejs/TSC
[node-core-utils-issues]: https://github.com/nodejs/node-core-utils/issues
[node-core-utils-credentials]: https://github.com/nodejs/node-core-utils#setting-up-credentials