| David Shevitz | 42135f9 | 2017-07-13 09:52:28 -0700 | [diff] [blame] | 1 | = How Gerrit Works |
| 2 | |
| Janet Davies | 8590902 | 2018-09-18 11:12:35 -0700 | [diff] [blame] | 3 | To learn how Gerrit fits into and complements the developer workflow, consider |
| 4 | a typical project. The following project contains a central source repository |
| Janet Davies | ffd4776 | 2018-07-17 13:50:32 -0700 | [diff] [blame] | 5 | (_Authoritative Repository_) that serves as the authoritative version of the |
| 6 | project's contents. |
| David Shevitz | 42135f9 | 2017-07-13 09:52:28 -0700 | [diff] [blame] | 7 | |
| Janet Davies | 8590902 | 2018-09-18 11:12:35 -0700 | [diff] [blame] | 8 | .Central Source Repository |
| 9 | image::images/intro-quick-central-repo.png[Authoritative Source Repository] |
| David Shevitz | 42135f9 | 2017-07-13 09:52:28 -0700 | [diff] [blame] | 10 | |
| Janet Davies | 8590902 | 2018-09-18 11:12:35 -0700 | [diff] [blame] | 11 | When implemented, Gerrit becomes the central source repository and introduces |
| 12 | an additional concept: a store of _Pending Changes_. |
| David Shevitz | 42135f9 | 2017-07-13 09:52:28 -0700 | [diff] [blame] | 13 | |
| Janet Davies | 8590902 | 2018-09-18 11:12:35 -0700 | [diff] [blame] | 14 | .Gerrit as the Central Repository |
| 15 | image::images/intro-quick-central-gerrit.png[Gerrit as the Central Repository] |
| David Shevitz | 42135f9 | 2017-07-13 09:52:28 -0700 | [diff] [blame] | 16 | |
| Janet Davies | 8590902 | 2018-09-18 11:12:35 -0700 | [diff] [blame] | 17 | When Gerrit is configured as the central source repository, all code changes |
| 18 | are sent to Pending Changes for others to review and discuss. When enough |
| 19 | reviewers have approved a code change, you can submit the change to the code |
| 20 | base. |
| David Shevitz | 42135f9 | 2017-07-13 09:52:28 -0700 | [diff] [blame] | 21 | |
| Janet Davies | ffd4776 | 2018-07-17 13:50:32 -0700 | [diff] [blame] | 22 | In addition to the store of Pending Changes, Gerrit captures notes and comments |
| 23 | made about each change. This enables you to review changes at your convenience |
| Janet Davies | 8590902 | 2018-09-18 11:12:35 -0700 | [diff] [blame] | 24 | or when a conversation about a change can't happen in person. In addition, |
| 25 | notes and comments provide a history of each change (what was changed and why and |
| 26 | who reviewed the change). |
| David Shevitz | 42135f9 | 2017-07-13 09:52:28 -0700 | [diff] [blame] | 27 | |
| Janet Davies | 8590902 | 2018-09-18 11:12:35 -0700 | [diff] [blame] | 28 | Like any repository hosting product, Gerrit provides a powerful |
| 29 | link:access-control.html[access control model], which enables you to |
| 30 | fine-tune access to your repository. |
| David Shevitz | 42135f9 | 2017-07-13 09:52:28 -0700 | [diff] [blame] | 31 | |
| 32 | GERRIT |
| 33 | ------ |
| 34 | Part of link:index.html[Gerrit Code Review] |
| 35 | |
| 36 | SEARCHBOX |
| 37 | --------- |
