diff --git a/cpp/ql/lib/semmle/code/cpp/headers/PreprocBlock.qll b/cpp/ql/lib/semmle/code/cpp/headers/PreprocBlock.qll
index 230886503d3..4d6b2212bcf 100644
--- a/cpp/ql/lib/semmle/code/cpp/headers/PreprocBlock.qll
+++ b/cpp/ql/lib/semmle/code/cpp/headers/PreprocBlock.qll
@@ -1,3 +1,10 @@
+/**
+ * This library offers a view of preprocessor branches (`#if`, `#ifdef`,
+ * `#ifndef`, `#elif` and `#else`) as blocks of code between the opening and
+ * closing directives, with navigable parent-child relationships to other
+ * blocks. The main class is `PreprocessorBlock`.
+ */
+
 import cpp
 
 /**