diff --git a/doc/developer-guidelines.sgml b/doc/developer-guidelines.sgml
index 8c2f2b96..b332c277 100644
--- a/doc/developer-guidelines.sgml
+++ b/doc/developer-guidelines.sgml
@@ -241,6 +241,83 @@
Note: Not all plugins are coded to expect ranges in this format yet.
There will be some work in providing multiple metrics.
+
+ Example ranges
+
+
+
+ Range definition
+ Generate an alert if x...
+
+
+
+
+ 10
+ < 0 or > 10, (outside the range of {0 .. 10})
+
+
+ 10:
+ < 10, (outside {10 .. ∞})
+
+
+ ~:10
+ > 10, (outside the range of {-∞ .. 10})
+
+
+ 10:20
+ < 10 or > 20, (outside the range of {10 .. 20})
+
+
+ @10:20
+ ≥ 10 and ≤ 20, (inside the range of {10 .. 20})
+
+
+ 10
+ < 0 or > 10, (outside the range of {0 .. 10})
+
+
+
+
+ Command line examples
+
+
+
+ Command line
+ Meaning
+
+
+
+
+ check_stuff -w10 -c20
+ Critical if "stuff" is over 20, else warn if over 10 (will be critical if "stuff" is less than 0)
+
+
+ check_stuff -w~:10 -c~:20
+ Same as above. Negative "stuff" is OK
+
+
+ check_stuff -w10: -c20
+ Critical if "stuff" is over 20, else warn if "stuff" is below 10 (will be critical if "stuff" is less than 0)
+
+
+ check_stuff -c1:
+ Critical if "stuff" is less than 1
+
+
+ check_stuff -w~:0 -c10
+ Critical if "stuff" is above 10; Warn if "stuff" is above zero
+
+
+ check_stuff -c5:6
+ The only noncritical range is 5:6
+
+
+ check_stuff -c10:20
+ Critical if "stuff" is 10 to 20
+
+
+
+