code-owners: Clarify that parents of imported OWNERS files are ignored
Bug: Issue 15089
Signed-off-by: Edwin Kempin <ekempin@google.com>
Change-Id: I3f7b39480cbca1856141cc854caa038a4196ecda
diff --git a/resources/Documentation/backend-find-owners.md b/resources/Documentation/backend-find-owners.md
index 3d40a8e..18fb11e 100644
--- a/resources/Documentation/backend-find-owners.md
+++ b/resources/Documentation/backend-find-owners.md
@@ -194,13 +194,17 @@
hence the fallback code owners should not be applied.
When referencing an external `OWNERS` file via the `file` keyword, only
-non-restricted [access grants](#accessGrants) are imported. This means
-`per-file` rules from the referenced `OWNERS` file are not pulled in and also
-any [set noparent](#setNoparent) line in the referenced `OWNERS` file is
-ignored, but recursive imports are being resolved.
+non-restricted [access grants](#accessGrants) are imported. If they contain
+imports (via the `file` or [include](#includeKeyword) keyword) they are
+recursively resolved. This means for the referenced `OWNERS` files the following
+things are ignored and not pulled in:
-To also import `per-file` rules and any [set noparent](#setNoparent) line use
-the [include](#includeKeyword) keyword instead.
+1. `per-file` rules
+2. any [set noparent](#setNoparent) line
+3. `OWNERS` files in parent directories
+
+To also import `per-file` rules and any [set noparent](#setNoparent) line (1. +
+2.) use the [include](#includeKeyword) keyword instead.
#### <a id="includeKeyword">include keyword
