Printable idea sheet
comment_reference
reqlan rq/reference_types.rq:57
Katz 0.119
Inbound reference from comments in non- `.rq` source: `rq:idea` / `rq:idea`.
Qualified paths may use import-root aliases ( `rq:idea` ) per configuration_import_root_alias and comment_reference_import_root_alias.
Spec: references_in_functional_code_comments
Syntax note: comment_reference. Resolve: reqlan-comment-resolver.ts.
Unresolved: comment_reference_resolution_error.
Index edge kind `comment_link`. Related capture of those files: referenced_files.
Indexer: index_code_files.
- implementation
- reqlan-comment-resolver.ts, types.ts, register-comment-reference-links.ts, comment-reference-path-context.ts, reqlan-comment-diagnostics.ts, comment.rs
- status
- done
- tests
- references.test.ts:finds rq: bracket comment references in line comments, references.test.ts:finds rq: comment references in block comments, linking.test.ts:comment references in source files resolve to rq ideas, code_file_index.rs:indexes_comment_references_from_non_rq_files, comment-reference-resolution.test.ts:creates a document link for an import-root aliased comment reference, against the workspace folder for extension comment links
Interactive page: comment_reference