# Owners

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 `OWNERS` files.

## Contents

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.

## Responsibilities

Fuchsia requires changes to have an OWNERS +2 review. However, many OWNERS files
contain a `*` allowing anyone to provide such a +2.

## Tools

INTK-108 tracks the work to stand up more infra tooling around these,
such as suggesting reviewers automatically in Gerrit.

## Format

We use the [Gerrit find-owners plugin][find-owners] 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:

```
validuser1@google.com
validuser2@google.com

# COMPONENT: TopComponent>SubComponent
```

[find-owners]: https://gerrit.googlesource.com/plugins/find-owners/+/master/src/main/resources/Documentation/about.md