Doc/tutorial/part2.md: Align headings with part1.md

Substitute `Part` with `Step` on this file's headings and use present
tense instead of gerund.

Change-Id: Ic130ed9865be43716e7de3121534761d9fc2ae8d
Signed-off-by: Angel Pons <th3fanbus@gmail.com>
Reviewed-on: https://review.coreboot.org/c/coreboot/+/37933
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
Reviewed-by: Jacob Garber <jgarber1@ualberta.ca>
This commit is contained in:
Angel Pons 2019-12-25 12:10:46 +01:00 committed by Patrick Georgi
parent 93b343a779
commit a8ab2b33a4
1 changed files with 13 additions and 13 deletions

View File

@ -1,8 +1,8 @@
# Tutorial, part 2: Submitting a patch to coreboot.org # Tutorial, part 2: Submitting a patch to coreboot.org
## Part 1: Setting up an account at coreboot.org ## Step 1: Set up an account at coreboot.org
If you already have an account, skip to Part 2. If you already have an account, skip to Step 2.
Otherwise, go to <https://review.coreboot.org> in your preferred web browser. Otherwise, go to <https://review.coreboot.org> in your preferred web browser.
Select **Sign in** in the upper right corner. Select **Sign in** in the upper right corner.
@ -12,13 +12,13 @@ select **Google OAuth2** (gerrit-oauth-provider plugin). **Note:** Your
username for the account will be the username of the account you used to username for the account will be the username of the account you used to
sign-in with. (ex. your Google username). sign-in with. (ex. your Google username).
## Part 2a: Set up RSA Private/Public Key ## Step 2a: Set up RSA Private/Public Key
If you prefer to use an HTTP password instead, skip to Part 2b. If you prefer to use an HTTP password instead, skip to Step 2b.
For the most up-to-date instructions on how to set up SSH keys with Gerrit go to For the most up-to-date instructions on how to set up SSH keys with Gerrit go to
<https://gerrit-documentation.storage.googleapis.com/Documentation/2.14.2/user-upload.html#configure_ssh> <https://gerrit-documentation.storage.googleapis.com/Documentation/2.14.2/user-upload.html#configure_ssh>
and follow the instructions there. Then, skip to Part 3. and follow the instructions there. Then, skip to Step 3.
Additionally, that section of the Web site provides explanation on starting Additionally, that section of the Web site provides explanation on starting
an ssh-agent, which may be particularly helpful for those who anticipate an ssh-agent, which may be particularly helpful for those who anticipate
@ -44,7 +44,7 @@ forego the password altogether as you will be using it very often.
Open `id_rsa.pub`, copy all contents and paste into the textbox under Open `id_rsa.pub`, copy all contents and paste into the textbox under
"Add SSH Public Key" in the https://review.coreboot.org webpage. "Add SSH Public Key" in the https://review.coreboot.org webpage.
## Part 2b: Setting up an HTTP Password ## Step 2b: Set up an HTTP Password
Alternatively, instead of using SSH keys, you can use an HTTP password. To do so, Alternatively, instead of using SSH keys, you can use an HTTP password. To do so,
after you select your name and click on **Settings** on the left-hand side, rather after you select your name and click on **Settings** on the left-hand side, rather
@ -72,7 +72,7 @@ If that still doesn't allow you to pull or push changes to the server, the
proxy is likely tampering with the data stream, in which case there's nothing proxy is likely tampering with the data stream, in which case there's nothing
we can do. we can do.
## Part 3: Clone coreboot and configure it for submitting patches ## Step 3: Clone coreboot and configure it for submitting patches
On Gerrit, click on the **Browse** tab in the upper left corner and select On Gerrit, click on the **Browse** tab in the upper left corner and select
**Repositories**. From the listing, select the "coreboot" repo. You may have **Repositories**. From the listing, select the "coreboot" repo. You may have
@ -101,7 +101,7 @@ and other configurations.
cd coreboot cd coreboot
make gitconfig make gitconfig
## Part 4: Submit a commit ## Step 4: Submit a commit
An easy first commit to make is fixing existing checkpatch errors and warnings An easy first commit to make is fixing existing checkpatch errors and warnings
in the source files. To see errors that are already present, build the files in in the source files. To see errors that are already present, build the files in
@ -119,9 +119,9 @@ and can be submitted for review.
Once you finish making your desired changes, use the command line to stage Once you finish making your desired changes, use the command line to stage
and submit your changes. An alternative and potentially easier way to stage and submit your changes. An alternative and potentially easier way to stage
and submit commits is to use git cola, a graphical user interface for git. For and submit commits is to use git cola, a graphical user interface for git. For
instructions on how to do so, skip to Part 4b. instructions on how to do so, skip to Step 4b.
## Part 4a: Using the command line to stage and submit a commit ## Step 4a: Use the command line to stage and submit a commit
To use the command line to stage a commit, run To use the command line to stage a commit, run
@ -181,7 +181,7 @@ using git. You may wish to review the [Gerrit code review workflow
documentation](https://gerrit-review.googlesource.com/Documentation/intro-user.html#code-review), documentation](https://gerrit-review.googlesource.com/Documentation/intro-user.html#code-review),
especially if you plan to work on multiple changes at the same time. especially if you plan to work on multiple changes at the same time.
## Part 4b: Using git cola to stage and submit a commit ## Step 4b: Use git cola to stage and submit a commit
If git cola is not installed on your machine, see If git cola is not installed on your machine, see
<https://git-cola.github.io/downloads.html> for download instructions. <https://git-cola.github.io/downloads.html> for download instructions.
@ -242,7 +242,7 @@ explained in the extended description.
When ready, select 'Commit' again. Once all errors have been satisfied When ready, select 'Commit' again. Once all errors have been satisfied
and the commit succeeds, move to the command line and run `git push`. and the commit succeeds, move to the command line and run `git push`.
## Part 5: Getting your commit reviewed ## Step 5: Let others review your commit
Your commits can now be seen on review.coreboot.org if you select "Your" Your commits can now be seen on review.coreboot.org if you select "Your"
and click on "Changes" and can be reviewed by others. Your code will and click on "Changes" and can be reviewed by others. Your code will
@ -252,7 +252,7 @@ users may also give your commit +1. For a commit to be merged, it needs
to receive a +2. **Note:** A +1 and a +1 does not make a +2. Only certain users to receive a +2. **Note:** A +1 and a +1 does not make a +2. Only certain users
can give a +2. can give a +2.
## Part 6 (optional): bash-git-prompt ## Step 6 (optional): bash-git-prompt
To help make it easier to understand the state of the git repository To help make it easier to understand the state of the git repository
without running `git status` or `git log`, there is a way to make the without running `git status` or `git log`, there is a way to make the