docs/development/gerrit-setup.md

4 account. This is needed to participate in OpenBMC's Gerrit-based code reviews.
7 installed. E-mail account (recommended to use the same e-mail address for both
14 - `git config --global --add user.name "Your name" (eg. John Smith)`
15 - `git config --global --add user.email "youremail@your-domain" (eg. jsmith@somedomain.com)`
16 - (Optional)
17   `git config --global --add diff.tool "preferred diff tool" (eg. gvimdiff or meld)`
21 Create keys: `ssh-keygen -t ed25519 -C "your_email@your-domain"`
23 - Recommended to use the defaults instead of picking your own directory/file
28 - <https://help.github.com/articles/adding-a-new-ssh-key-to-your-github-account/>
32 - Login to [Gerrit](https://gerrit.openbmc.org/) with your GitHub account.
33 - Go to <https://gerrit.openbmc.org/plugins/github-plugin/static/account.html>
34 - Your information should be auto-filled, so click "Next".
35 - If successful you should see a blank screen, feel free to exit out.
40 - Login to [Gerrit](https://gerrit.openbmc.org/)
41 - Enter your public SSH key created before in Settings -> SSH Keys -> New SSH
42   key
43 - Click on "ADD NEW SSH KEY"
44 - If succesfull you should see your public key added and with the status "Valid"
46 ### Add e-mail to Gerrit
48 - Login to [Gerrit](https://gerrit.openbmc.org/)
49 - Enter e-mail in Settings -> Contact Information -> Register New E-Mail
50 - Check e-mail for confirmation and click the link to confirm
54 - Enter your full name in Settings -> Profile -> Full name
67 - **NOTE**: There is a bug in AFS that requires `AFSTokenPassing no` to be added
69 - Your Gerrit Username can be found in Gerrit under Settings -> Profile ->
71 - Ensure proper permissions for for your .ssh directory: `chmod 600 ~/.ssh/*`
77 - `git clone ssh://openbmc.gerrit/openbmc/docs`
78 - If successful you should see something like:
86 gitdir=$(git rev-parse --git-dir)
87 curl https://gerrit.openbmc.org/tools/hooks/commit-msg -o ${gitdir}/hooks/commit-msg
88 chmod +x ${gitdir}/hooks/commit-msg
91 This will enhance the `git commit` command to add a `Change-Id` to your commit
94 ### Push Code Change to Gerrit
96 Now that your workstation and Gerrit are configured, you are ready to make code
97 changes and push them to Gerrit for code review. Here is what the basic workflow
100 - Make your code changes
101 - Add those files to the index to be committed:
103 - Commit your changes, adding a Signed-off-by line to it (more on
104 … commit messages](https://github.com/openbmc/docs/blob/master/CONTRIBUTING.md#submitting-changes)):
105   `git commit --signoff`
106 - Push your changes to Gerrit for code review:
108 - Go to [Gerrit web interface](https://gerrit.openbmc.org/), click on your new
114 set up Gerrit and know how to submit your code changes for review!