policy

diff --git a/Documentation/user/writing-texinfo.txt b/Documentation/user/writing-texinfo.txt
index ca9668d375abb900bc94807672580177534c8929..497195a8cb95414938993b8458db36b84f979fef 100644 (file)
--- a/Documentation/user/writing-texinfo.txt
+++ b/Documentation/user/writing-texinfo.txt
@@ -74,6 +74,9 @@ commands.
 
 * If possible, end with a complete bar.
 
+* Comments should go on their own line, and be placed before the
+  line(s) to which they refer.
+
 * If you only have one bar per line, omit bar checks.  If you
   put more than one bar per line (not recommended), then include
   bar checks.