diff --git a/ui_test/src/comments.rs b/ui_test/src/comments.rs
index 193cda68b9aa..64f999f54101 100644
--- a/ui_test/src/comments.rs
+++ b/ui_test/src/comments.rs
@@ -39,6 +39,8 @@ impl Comments {
         Self::parse(path, &content)
     }
 
+    /// Parse comments in `content`.
+    /// `path` is only used to emit diagnostics if parsing fails.
     pub fn parse(path: &Path, content: &str) -> Self {
         let mut this = Self::default();
         let error_pattern_regex =