1 .. This work is licensed under a Creative Commons Attribution 4.0
2 .. International License. http://creativecommons.org/licenses/by/4.0
3 .. Copyright 2020 Nokia.
8 This chapter is based on the `Git Guide <https://docs.releng.linuxfoundation.org/en/latest/git.html>`_
9 and the `Gerrit Guide <https://docs.releng.linuxfoundation.org/en/latest/gerrit.html>`_
10 in the Linux Foundation Releng Documentation.
15 Before you start, you should have an LFID account (sign up
16 `here <https://identity.linuxfoundation.org/>`_).
23 For Debian based systems:
27 sudo apt-get install git -y
30 For rpm based systems:
34 sudo dnf install git -y
37 For MacOS systems, install `homebrew <http://brew.sh>`_ and install Git
43 .. note:: For more information on git, see the `Git Guide <https://docs.releng.linuxfoundation.org/en/latest/git.html>`_ in the Linux Foundation Releng Documentation.
48 1. Set the author name or email used to sign off a commit with the following commands.
52 git config --local user.name "Your Name"
53 git config --local user.email yourname@example.com
55 .. note:: Your name and e-mail address (including capitalization) must match the one you entered when creating your LFID account.
57 2. Optionally, change the Git commit editor to your preferred editor, for example, vim.
61 git config --global core.editor "vim"
66 1. Install git-review.
70 pip install git-review
72 .. note:: If you don’t have pip installed already, follow the `installation documentation <https://pip.pypa.io/en/stable/installing/#installing-with-get-pip-py>`_ for pip.
86 Your public key is now available as .ssh/id_rsa.pub in your home folder.
88 2. Print the generated key to the terminal and copy it.
94 3. On the project gerrit page, go to Settings.
96 .. figure:: https://docs.releng.linuxfoundation.org/en/latest/_images/gerrit-settings.png
97 :alt: Settings page for your Gerrit account
100 4. Click **SSH Public Keys** under **Settings**.
102 5. Click **Add Key**.
104 6. In the **Add SSH Public Key** text box, paste the contents of your **id\_rsa.pub** file and then click **Add**.
106 .. figure:: https://docs.releng.linuxfoundation.org/en/latest/_images/gerrit-ssh-keys.png
107 :alt: Adding your SSH key
110 Setting up CLA as an individual contributor
111 -------------------------------------------
113 1. Navigate to **Settings** — the gear icon on the upper right corner, and click **Agreements** from the menu on the left:
115 .. figure:: https://raw.githubusercontent.com/communitybridge/docs/master/.gitbook/assets/settings-icon.png
117 .. figure:: https://raw.githubusercontent.com/communitybridge/docs/master/.gitbook/assets/agreements.png
119 2. Click **New Contributor Agreement**.
121 .. figure:: https://raw.githubusercontent.com/communitybridge/docs/master/.gitbook/assets/agreement-link.png
123 3. New Contributor Agreement types appear:
125 .. figure:: https://raw.githubusercontent.com/communitybridge/docs/master/.gitbook/assets/new-contributor-agreement.png
127 4. Choose the Individual CLA option.
129 .. figure:: CLA_types.png
131 5. Click the **Please review the agreement link** and then click the message link that appears:
133 .. figure:: https://raw.githubusercontent.com/communitybridge/docs/master/.gitbook/assets/cla-gerrit-icla-proceed-to-sign-cla.png
135 6. Sign in to EasyCLA if you are prompted.
137 7. Select **Company**.
139 .. note:: To contribute to this project, you must be authorized under a signed Contributor License Agreement. You are contributing on behalf of your work for a company.
141 If any further prompts appear, follow the steps described at the below links:
143 - `If a Confirmation of Association with statement appears <https://docs.linuxfoundation.org/docs/communitybridge/easycla/contributors/contribute-to-a-gerrit-project#if-a-confirmation-of-association-with-statement-appears>`_
144 - `If your company has not signed CCLA <https://docs.linuxfoundation.org/docs/communitybridge/easycla/contributors/contribute-to-a-gerrit-project#if-your-company-has-not-signed-ccla>`_
145 - `If you are not added to the approved list <https://docs.linuxfoundation.org/docs/communitybridge/easycla/contributors/contribute-to-a-gerrit-project#if-you-are-not-added-to-the-approved-list>`_
146 - `If Company is not in the list <https://docs.linuxfoundation.org/docs/communitybridge/easycla/contributors/contribute-to-a-gerrit-project#if-company-is-not-in-the-list>`_
148 8. Complete the form and click **SEND**.
150 The CCLA manager signs a Corporate CLA and adds you to the approved list.