1.1 Comments

Where to put comments describing functions: Because of risk of divergence, we prefer to keep most function describing comments in only one place: just above the actual function definition. Some people prefer to put that documentation in the .h file. In any case, it should appear in just one place unless you can ensure that the multiple copies will always remain identical.