mirror of
https://github.com/Cockatrice/Cockatrice.git
synced 2026-07-06 05:23:56 -07:00
Update .github/CONTRIBUTING.md
Co-authored-by: tooomm <tooomm@users.noreply.github.com>
This commit is contained in:
parent
18a77dd78b
commit
69b076e1f9
1 changed files with 3 additions and 3 deletions
6
.github/CONTRIBUTING.md
vendored
6
.github/CONTRIBUTING.md
vendored
|
|
@ -211,11 +211,11 @@ into smaller parts, for example at spaces or after opening a brace.
|
||||||
|
|
||||||
### Documentation Comments ###
|
### Documentation Comments ###
|
||||||
|
|
||||||
Use [Doxygen](https://www.doxygen.nl/) for API documentation:
|
Use [Doxygen](https://www.doxygen.nl/) for code documentation:
|
||||||
|
|
||||||
- **Doc blocks**: Use `/** @brief Description */` (JavaDoc-style), not `///`
|
- **Doc blocks**: Use `/** @brief Description */` (Javadoc-style), not `///`
|
||||||
- **Member comments**: Use trailing `///<` for inline member documentation
|
- **Member comments**: Use trailing `///<` for inline member documentation
|
||||||
- **TODOs**: Use `//! \todo Description` (Qt-style) so Doxygen collects them into a Todo List
|
- **TODOs**: Use `//! \todo Description` (Qt-style), Doxygen collects them into a Todo List
|
||||||
(uses [Qt-style comments](https://www.doxygen.nl/manual/docblocks.html) with
|
(uses [Qt-style comments](https://www.doxygen.nl/manual/docblocks.html) with
|
||||||
Doxygen's [\todo command](https://www.doxygen.nl/manual/commands.html#cmdtodo))
|
Doxygen's [\todo command](https://www.doxygen.nl/manual/commands.html#cmdtodo))
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue