| # Owners | |
| Each file in Fuchsia has a set of owners. These are tracked in files | |
| named `OWNERS`. One of these files is present in the root of the | |
| repository, and many directories have their own `OWNERS` files too. | |
| ## Contents | |
| Each `OWNERS` file lists a number of individuals (by their email address) who are | |
| familiar with and can provide code reviews for the contents of that directory. | |
| It's important to have at least two individuals in an `OWNERS` file. Having areas | |
| of Fuchsia with a single owner leads to single points of failure and having multiple | |
| owners ensures that knowledge and ownership is shared over areas of Fuchsia. | |
| ## Responsibilities | |
| Fuchsia requires changes to have an `Code-Review +2` review, which anyone in the | |
| 'OWNERS' file can provide. In addition, many `OWNERS` files | |
| contain a `*` allowing anyone to provide such a `+2`. | |
| ## Tools | |
| Gerrit has a "find owners" button that will list all the owners for all the | |
| files modified in a given change. More information on this is available on the | |
| [Gerrit find-owners plugin][find-owners] page. | |
| ## Format | |
| Fuchsia uses the [Gerrit file syntax][owners-syntax] for `OWNERS` | |
| files, with the addition of a comment indicating the default Monorail component | |
| to use when filing issues related to the contents of this directory. | |
| Here's an example `OWNERS` file: | |
| ```none | |
| validuser1@example.com | |
| validuser2@example.com | |
| # COMPONENT: TopComponent>SubComponent | |
| ``` | |
| [find-owners]: https://gerrit.googlesource.com/plugins/find-owners/+/master/src/main/resources/Documentation/about.md | |
| [owners-syntax]: https://gerrit.googlesource.com/plugins/find-owners/+/master/src/main/resources/Documentation/syntax.md |