diff --git a/unified/ql/lib/codeql/unified/Comments.qll b/unified/ql/lib/codeql/unified/Comments.qll
index c1b1bb9df90..e839af2dbee 100644
--- a/unified/ql/lib/codeql/unified/Comments.qll
+++ b/unified/ql/lib/codeql/unified/Comments.qll
@@ -1,3 +1,5 @@
+/** Provides classes for working with comments. */
+
 private import unified
 
 /**
@@ -5,6 +7,9 @@ private import unified
  */
 class Comment extends TriviaToken {
   // At the moment, comments are the only type trivia token we extract
+  /**
+   * Gets the text inside this comment, not counting the delimeters.
+   */
   string getCommentText() {
     result = this.getValue().regexpCapture("//(.*)", 1)
     or