diff --git a/CONVENTIONS b/CONVENTIONS
index 7e78a9c8d..60811b0ba 100644
--- a/CONVENTIONS
+++ b/CONVENTIONS
@@ -50,6 +50,12 @@ error.  This permits common POSIX result testing:
 ----
 
 
+Documentation Fomatting
+-----------------------
+
+All comments should conform to Doxygen "javadoc" style conventions
+for formatting the public API documentation.
+
 
 Public Header Format
 --------------------