Patrick Williams | 77b1e00 | 2025-08-22 11:03:28 -0400 | [diff] [blame] | 1 | # OWNERS |
| 2 | # ------ |
Ed Tanous | 229bf4f | 2025-08-19 15:43:03 -0700 | [diff] [blame] | 3 | # |
Patrick Williams | 77b1e00 | 2025-08-22 11:03:28 -0400 | [diff] [blame] | 4 | # The OWNERS file maintains the list of individuals responsible for various |
| 5 | # parts of this repository, including code review and approval. We use the |
| 6 | # Gerrit 'owners' plugin, which consumes this file, along with some extra |
| 7 | # keywords for our own purposes and tooling. |
Ed Tanous | 229bf4f | 2025-08-19 15:43:03 -0700 | [diff] [blame] | 8 | # |
Patrick Williams | 77b1e00 | 2025-08-22 11:03:28 -0400 | [diff] [blame] | 9 | # For details on the configuration used by 'owners' see: |
| 10 | # https://gerrit.googlesource.com/plugins/owners/+/refs/heads/master/owners/src/main/resources/Documentation/config.md |
Ed Tanous | 229bf4f | 2025-08-19 15:43:03 -0700 | [diff] [blame] | 11 | # |
Patrick Williams | 77b1e00 | 2025-08-22 11:03:28 -0400 | [diff] [blame] | 12 | # An OWNERS file must be in the root of a repository but may also be present |
| 13 | # in any subdirectory. The contents of the subdirectory OWNERS file are |
| 14 | # combined with parent directories unless 'inherit: false' is set. |
Ed Tanous | 229bf4f | 2025-08-19 15:43:03 -0700 | [diff] [blame] | 15 | # |
Patrick Williams | 77b1e00 | 2025-08-22 11:03:28 -0400 | [diff] [blame] | 16 | # The owners file is YAML and has [up to] 4 top-level keywords. |
| 17 | # * owners: A list of individuals who have approval authority on the |
| 18 | # repository. |
Ed Tanous | 229bf4f | 2025-08-19 15:43:03 -0700 | [diff] [blame] | 19 | # |
Patrick Williams | 77b1e00 | 2025-08-22 11:03:28 -0400 | [diff] [blame] | 20 | # * reviewers: A list of individuals who have requested review notification |
| 21 | # on the repository. |
Ed Tanous | 229bf4f | 2025-08-19 15:43:03 -0700 | [diff] [blame] | 22 | # |
Patrick Williams | 77b1e00 | 2025-08-22 11:03:28 -0400 | [diff] [blame] | 23 | # * matchers: A list of specific file/path matchers for granular 'owners' and |
| 24 | # 'reviewers'. See 'owners' plugin documentation. |
Ed Tanous | 229bf4f | 2025-08-19 15:43:03 -0700 | [diff] [blame] | 25 | # |
Patrick Williams | 77b1e00 | 2025-08-22 11:03:28 -0400 | [diff] [blame] | 26 | # * openbmc: A list of openbmc-specific meta-data about owners and reviewers. |
| 27 | # - name: preferred name of the individual. |
| 28 | # - email: preferred email address of the individual. |
| 29 | # - discord: Discord nickname of the individual. |
Ed Tanous | 229bf4f | 2025-08-19 15:43:03 -0700 | [diff] [blame] | 30 | # |
Patrick Williams | 77b1e00 | 2025-08-22 11:03:28 -0400 | [diff] [blame] | 31 | # It is expected that these 4 sections will be listed in the order above and |
| 32 | # data within them will be kept sorted. |
Ed Tanous | 229bf4f | 2025-08-19 15:43:03 -0700 | [diff] [blame] | 33 | |
| 34 | owners: |
| 35 | - ed@tanous.net |
| 36 | - patrick@stwcx.xyz |
| 37 | |
Patrick Williams | 77b1e00 | 2025-08-22 11:03:28 -0400 | [diff] [blame] | 38 | reviewers: |
| 39 | |
| 40 | matchers: |
| 41 | |
| 42 | openbmc: |
| 43 | - name: Ed Tanous |
| 44 | email: ed@tanous.net |
| 45 | discord: edtanous |
| 46 | - name: Patrick Williams |
| 47 | email: patrick@stwcx.xyz |
| 48 | discord: stwcx |