| ... |
... |
@@ -23,14 +23,14 @@ |
| 23 |
23 |
* Prescriptive comments |
| 24 |
24 |
* Diary comments |
| 25 |
25 |
* Chatter |
| 26 |
|
-* Position identifier, e.g. "// End of function" |
| 27 |
|
-* Comments after closing parentheses, originally intended to be useful for long functions by highlighting sections, e.g. "} // End of for loop". However, they should be avoided and the function should be shortened. |
| 28 |
|
-* Attributions: Something used to keep track of who wrote or modified a piece of code. Usually handled automatically by a source code control system like Git. |
| 29 |
|
-* Asides: An off-topic comment in the source code, which is usually to be avoided because it distracts from the main purpose of the code, making it harder to understand. |
|
26 |
+* Position identifier |
|
27 |
+* Comments after closing parentheses to emphasize sections that may be useful for long functions. They should be avoided and the function shortened. |
|
28 |
+* Attributions |
|
29 |
+* Asides |
| 30 |
30 |
* Commented code |
| 31 |
31 |
* HTML comments |
| 32 |
|
-* Non-local information that is not directly related to the immediate code. |
|
32 |
+* Non-local information |
| 33 |
33 |
* Too much information |
| 34 |
34 |
* Unclear context |
| 35 |
|
-* Function headers, which are comments that precede a function and describe what the function does, its parameters, return values, etc. |
|
35 |
+* Function header |
| 36 |
36 |
* Javadocs in non-public API's |
