diff --git a/ql/src/ideContextual.qll b/ql/src/ideContextual.qll
index 97360578ea5..5945931126f 100644
--- a/ql/src/ideContextual.qll
+++ b/ql/src/ideContextual.qll
@@ -5,5 +5,8 @@
 
 import go
 
+/**
+ * Gets the `File` with encoded name `name`.
+ */
 cached
 File getEncodedFile(string name) { result.getAbsolutePath().replaceAll(":", "_") = name }
diff --git a/ql/src/semmle/go/security/InsecureFeatureFlag.qll b/ql/src/semmle/go/security/InsecureFeatureFlag.qll
index 2f5d61c0c0b..c1b6db0d4f7 100644
--- a/ql/src/semmle/go/security/InsecureFeatureFlag.qll
+++ b/ql/src/semmle/go/security/InsecureFeatureFlag.qll
@@ -4,6 +4,9 @@
 
 import go
 
+/**
+ * Provides classes and predicates relating to flags that may indicate security expectations.
+ */
 module InsecureFeatureFlag {
   /**
    * A kind of flag that may indicate security expectations regarding the code it guards.