doc,meta: refresh wording in colab guide
PR-URL: https://github.com/nodejs/node/pull/23292 Refs: https://github.com/nodejs/node/pull/23249 Reviewed-By: Michaël Zasso <targos@protonmail.com> Reviewed-By: Vse Mozhet Byt <vsemozhetbyt@gmail.com> Reviewed-By: Anna Henningsen <anna@addaleax.net> Reviewed-By: Trivikram Kamat <trivikr.dev@gmail.com> Reviewed-By: Rich Trott <rtrott@gmail.com>
This commit is contained in:
parent
0f8eaa4712
commit
39ae000429
@ -503,10 +503,11 @@ The TSC should serve as the final arbiter where required.
|
||||
|
||||
1. Never use GitHub's green ["Merge Pull Request"][] button. Reasons for not
|
||||
using the web interface button:
|
||||
* The merge method will add an unnecessary merge commit.
|
||||
* The squash & merge method can add metadata (the PR #) to the commit title.
|
||||
* If more than one author has contributed to the PR, keep the most recent
|
||||
author when squashing.
|
||||
* The "Create a merge commit" method will add an unnecessary merge commit.
|
||||
* The "Squash and merge" method will add metadata (the PR #) to the commit
|
||||
title. If more than one author has contributed to the PR, squashing will
|
||||
only keep the most recent author.
|
||||
* The "Rebase and merge" method has no way of adding metadata to the commit.
|
||||
1. Make sure the CI is done and the result is green. If the CI is not green,
|
||||
check for flaky tests and infrastructure failures. Please check if those were
|
||||
already reported in the appropriate repository ([node][flaky tests] and
|
||||
@ -517,13 +518,12 @@ The TSC should serve as the final arbiter where required.
|
||||
present.
|
||||
1. Review the commit message to ensure that it adheres to the guidelines
|
||||
outlined in the [contributing][] guide.
|
||||
1. Add all necessary [metadata](#metadata) to commit messages before landing.
|
||||
See the commit log for examples such as [this
|
||||
one](https://github.com/nodejs/node/commit/b636ba8186) if unsure exactly how
|
||||
to format your commit messages.
|
||||
1. Add all necessary [metadata](#metadata) to commit messages before landing. If
|
||||
you are unsure exactly how to format the commit messages, use the commit log
|
||||
as a reference. See [this commit][commit-example] as an example.
|
||||
|
||||
Check PRs from new contributors to make sure the person's name and email address
|
||||
are correct before merging.
|
||||
For PRs from first time contributors, be [welcoming](#welcoming-first-time-contributors).
|
||||
Also, verify that their git settings are to their liking.
|
||||
|
||||
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.
|
||||
@ -901,6 +901,7 @@ If you cannot find who to cc for a file, `git shortlog -n -s <file>` may help.
|
||||
[`node-core-utils`]: https://github.com/nodejs/node-core-utils
|
||||
[backporting guide]: doc/guides/backporting-to-release-lines.md
|
||||
[contributing]: ./doc/guides/contributing/pull-requests.md#commit-message-guidelines
|
||||
[commit-example]: https://github.com/nodejs/node/commit/b636ba8186
|
||||
[flaky tests]: https://github.com/nodejs/node/issues?q=is%3Aopen+is%3Aissue+label%3A%22CI+%2F+flaky+test%22y
|
||||
[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
|
||||
|
Loading…
x
Reference in New Issue
Block a user