Each repository in the system has a set of owners. These are
tracked in files all aptly named
OWNERS. One of these will
always be present in the root of a repository. Many directories will
have their own
Each file lists a number of individuals (via their email address) who are familiar with and can provide code review for the contents of that directory. We strive to always have at least two individuals in a given file. Anything with just one is either too fine grained to deserve its own, or is in need of someone else to learn enough about the code to feel comfortable approving changes to it or answering questions about it.
Fuchsia requires changes to have an OWNERS +2 review. However, many OWNERS files
* allowing anyone to provide such a +2.
INTK-108 tracks the work to stand up more infra tooling around these, such as suggesting reviewers automatically in Gerrit.
We use the Gerrit find-owners plugin file format for our 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:
firstname.lastname@example.org email@example.com # COMPONENT: TopComponent>SubComponent