jsdoc: Further improvements to QueryContext docs

src/Scripting/QueryContext.ts

@@ -1,14 +1,19 @@
 import { TasksFile } from './TasksFile';
 
 /**
- * This interface is part of the implementation of placeholders.
- * Use {@link makeQueryContext} to make a QueryContext.
+ * This interface is part of the implementation of placeholders and scripting.
  *
- * QueryContext is a 'view' to pass in to {@link expandPlaceholders}.
+ * - Use {@link makeQueryContext} to make a {@link QueryContext}.
+ * - Or more commonly, if you have a {@link SearchInfo}, use {@link SearchInfo.queryContext}
+ *
+ * QueryContext is a 'view' to pass in to {@link expandPlaceholders} and
+ * to various methods of {@link TaskExpression}.
  *
  * It provides the following:
- * `queryContext.query.file` - where query.file is a {@link TasksFile} object.
- * So it supplies `query.file.path`, `query.file.folder`.
+ * - `queryContext.query.file` - where `query.file` is a {@link TasksFile} object.
+ *    So it supplies `query.file.path`, `query.file.folder`.
+ *
+ * @see SearchInfo
  */
 export interface QueryContext {
     query: {
@@ -19,6 +24,8 @@ export interface QueryContext {
 /**
  * Create a {@link QueryContext} to represent a query in note at the give path.
  * @param path
+ *
+ * @see SearchInfo.queryContext
  */
 export function makeQueryContext(path: string): QueryContext {
     const tasksFile = new TasksFile(path);