diff --git a/docs/querying/basics.md b/docs/querying/basics.md
index 65748d9f0..9ac37c041 100644
--- a/docs/querying/basics.md
+++ b/docs/querying/basics.md
@@ -188,6 +188,12 @@ in detail in the [expression language operators](operators.md) page.
 Prometheus supports several functions to operate on data. These are described
 in detail in the [expression language functions](functions.md) page.
 
+## Comments
+
+PromQL supports line comments that start with `#`. Example:
+
+        # This is a comment
+
 ## Gotchas
 
 ### Staleness