Document that per-file lines should not contain additional spaces

Signed-off-by: Edwin Kempin <>
Change-Id: Idaafa1784903b3c346c18a1f2fd9b1ae3e8b4a48
diff --git a/resources/Documentation/ b/resources/Documentation/
index 9d2fab5..223cebb 100644
--- a/resources/Documentation/
+++ b/resources/Documentation/
@@ -266,6 +266,13 @@
   per-file docs.config,*
+**NOTE:** It's important to not include additional spaces in `per-file` lines.
+E.g. "per-file docs.config," will make
+Richard Roe a code owner of the files "docs.config" and " test.config" (pay
+attention to the leading space), but not for the file "test.config". The correct
+line to make Richard Roe a code owner of the files "docs.config" and
+"test.config" would be "per-file docs.config,".
 ##### <a id="doNotUsePathExpressionsForSubdirectories">
 **NOTE:** It is discouraged to use path expressions that explicitly name
 subdirectories such as `my-subdir/*` as they will break when the subdirectory