22 lines
394 B
Plaintext
22 lines
394 B
Plaintext
Every section should be commented to explain its goal and how it works. This comment can be placed either just before or just after the section label.
|
|
|
|
|
|
== Noncompliant Code Example
|
|
|
|
----
|
|
UNCOMMENTED-SECTION SECTION.
|
|
----
|
|
|
|
|
|
== Compliant Solution
|
|
|
|
----
|
|
* Some comments
|
|
CORRECTLY-COMMENTED-SECTION SECTION.
|
|
|
|
ANOTHER-CORRECTLY-COMMENTED-SECTION SECTION.
|
|
* Some comments
|
|
----
|
|
|
|
|