mirror of
https://github.com/github/codeql.git
synced 2025-12-16 16:53:25 +01:00
Fix broken links to QLDoc specification
This commit is contained in:
@@ -6,7 +6,7 @@ Valid QL comments are known as QLDoc. This document describes the recommended st
|
||||
|
||||
### General requirements
|
||||
|
||||
1. Documentation must adhere to the [QLDoc specification](https://help.semmle.com/QL/ql-handbook/qldoc.html).
|
||||
1. Documentation must adhere to the [QLDoc specification](https://codeql.github.com/docs/ql-language-reference/ql-language-specification/#qldoc).
|
||||
1. Documentation comments should be appropriate for users of the code.
|
||||
1. Documentation for maintainers of the code must use normal comments.
|
||||
1. Use `/** ... */` for documentation, even for single line comments.
|
||||
|
||||
@@ -26,7 +26,7 @@ For examples of query files for the languages supported by CodeQL, visit the fol
|
||||
|
||||
## Metadata area
|
||||
|
||||
Query file metadata contains important information that defines the identifier and purpose of the query. The metadata is included as the content of a valid [QLDoc](https://help.semmle.com/QL/ql-handbook/qldoc.html) comment, on lines with leading whitespace followed by `*`, between an initial `/**` and a trailing `*/`. For example:
|
||||
Query file metadata contains important information that defines the identifier and purpose of the query. The metadata is included as the content of a valid [QLDoc](https://codeql.github.com/docs/ql-language-reference/ql-language-specification/#qldoc) comment, on lines with leading whitespace followed by `*`, between an initial `/**` and a trailing `*/`. For example:
|
||||
|
||||
```
|
||||
/**
|
||||
|
||||
Reference in New Issue
Block a user