[Summary view] [Print] [Text view]

   1  @title Owners Tool User Guide
   2  @group userguide
   3  
   4  Use Owners to define and/or monitor code you care about.
   5  
   6  = Packages =
   7  
   8  Owners tool allows you to define a code package by specifying a group of paths.
   9  The package can then be used to monitor the paths. For example, it can be used
  10  in Herald rules and in the "Related Commits" feature (see below).
  11  
  12  = Related Commits =
  13  
  14  Once the package is defined, all future commits touching any path defined in
  15  the package will be recorded as "Related Commits" of the package.
  16  
  17  = Commits Needing Attention =
  18  
  19  Owners tool enables the owners of the package to monitor the commits that might
  20  need attention. If "auditing" is enabled for a package, a related commit will
  21  be marked as "Needing Attention" if
  22  
  23    - it's neither authored nor reviewed by an owner of the package,
  24    - no revision found for the commit,
  25    - the commit author is not recognized, or
  26    - the author or the reviewer specified in the commits don't match the ones in
  27      the Differential revision
  28  
  29  The owners of the package can accept or specify concern for such commits by
  30  clicking the "Audit Status" link.