diff --git a/README-hacking b/README-hacking
index becff13..d2dfdd3 100644
--- a/README-hacking
+++ b/README-hacking
@@ -22,3 +22,10 @@
 line should be blank, and the remaining lines are usually ChangeLog-style
 entries for all affected files, except the leading TABs which should
 be omitted.
+
+
+Documentation
+=============
+All noteworthy changes should be mentioned in NEWS.  All changes in strace
+command interface should be reflected in the man page.  New options should
+be documented both in -h output and in the man page.