Address review comment

hvitved · hvitved · commit 40390d1adacd · 2025-04-22T15:08:39.000+02:00
diff --git a/ql/ql/src/codeql_ql/ast/Yaml.qll b/ql/ql/src/codeql_ql/ast/Yaml.qll
@@ -88,6 +88,16 @@ class QlPackDocument extends YamlDocument {
   }
 }
 
+/**
+ * Holds if `qlref` is a `.qlref` YAML document referencing a query
+ * at relative path `relativePath`, and `f` is a candidate folder
+ * in which to lookup the referenced query.
+ *
+ * `f` is either:
+ * - the root of the QL pack containing `qlref`,
+ * - the root of a QL pack that is a dependency of the QL pack containing `qlref`, or
+ * - the folder containing `qlref`.
+ */
 private predicate shouldAppend(QlRefDocument qlref, Folder f, string relativePath) {
   relativePath = qlref.getRelativeQueryPath() and
   (

Original file line number	Diff line number	Diff line change
`@@ -88,6 +88,16 @@ class QlPackDocument extends YamlDocument {`
`88`	`88`	`}`
`89`	`89`	`}`
`90`	`90`
	`91`	`+/**`
	`92`	+ * Holds if `qlref` is a `.qlref` YAML document referencing a query
	`93`	+ * at relative path `relativePath`, and `f` is a candidate folder
	`94`	`+ * in which to lookup the referenced query.`
	`95`	`+ *`
	`96`	+ * `f` is either:
	`97`	+ * - the root of the QL pack containing `qlref`,
	`98`	+ * - the root of a QL pack that is a dependency of the QL pack containing `qlref`, or
	`99`	+ * - the folder containing `qlref`.
	`100`	`+ */`
`91`	`101`	`private predicate shouldAppend(QlRefDocument qlref, Folder f, string relativePath) {`
`92`	`102`	`relativePath = qlref.getRelativeQueryPath() and`
`93`	`103`	`(`