summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--CONTRIBUTING.md12
1 files changed, 12 insertions, 0 deletions
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 217b1e3f0..2e275a166 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -84,6 +84,18 @@ Always prefer self-explanatory code over comments! Many times well-named
helper variables can make even complicated code read almost like plain
English.
+Comments are always in `/* ... */`, never `//`. The two comment styles
+in rpm codebase are:
+
+`/* Short and sweet */`
+
+```
+/*
+ * Multi-line comments should be formatted
+ * like this.
+ */
+```
+
### Error handling
Avoid multiple exit points from functions, these are an invitation to