diff --git a/doc/man/man7/cdist-hacker.text b/doc/man/man7/cdist-hacker.text
index d55f1c2f..03a348ed 100644
--- a/doc/man/man7/cdist-hacker.text
+++ b/doc/man/man7/cdist-hacker.text
@@ -59,7 +59,8 @@ HOW TO SUBMIT A NEW TYPE
 Submitting a type works as described above, with the additional requirement
 that a corresponding manpage named man.text in asciidoc format with
 the manpage-name "cdist-type__NAME" is included in the type directory
-AND asciidoc is able to compile it.
+AND asciidoc is able to compile it (i.e. do NOT have to many "=" in the second
+line).
 
 
 SEE ALSO