diff options
| author | Tony Wasserka <neobrainx@gmail.com> | 2014-12-07 13:53:42 +0100 |
|---|---|---|
| committer | Tony Wasserka <neobrainx@gmail.com> | 2014-12-07 13:53:42 +0100 |
| commit | f06922268a369c2b76ac2652c58516f915b71606 (patch) | |
| tree | 0cfbe4ee1bae212b4651cbe318e16ee5270c486d | |
| parent | Merge pull request #250 from Subv/cbranch_2 (diff) | |
| parent | Resolve doxycomment duplication debate (diff) | |
| download | yuzu-f06922268a369c2b76ac2652c58516f915b71606.tar yuzu-f06922268a369c2b76ac2652c58516f915b71606.tar.gz yuzu-f06922268a369c2b76ac2652c58516f915b71606.tar.bz2 yuzu-f06922268a369c2b76ac2652c58516f915b71606.tar.lz yuzu-f06922268a369c2b76ac2652c58516f915b71606.tar.xz yuzu-f06922268a369c2b76ac2652c58516f915b71606.tar.zst yuzu-f06922268a369c2b76ac2652c58516f915b71606.zip | |
| -rw-r--r-- | CONTRIBUTING.md | 1 |
1 files changed, 1 insertions, 0 deletions
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 82b66be75..c8c8e3884 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -27,6 +27,7 @@ Follow the indentation/whitespace style shown below. Do not use tabs, use 4-spac ### Comments * For regular comments, use C++ style (`//`) comments, even for multi-line ones. * For doc-comments (Doxygen comments), use `/// ` if it's a single line, else use the `/**` `*/` style featured in the example. Start the text on the second line, not the first containing `/**`. +* For items that are both defined and declared in two separate files, put the doc-comment only next to the associated declaration. (In a header file, usually.) Otherwise, put it next to the implementation. Never duplicate doc-comments in both places. ```cpp namespace Example { |