From b927ca813bd1b9a96b6ac14c5b57a76d4b73726a Mon Sep 17 00:00:00 2001
From: Chris Lattner
Comments are one critical part of readability and maintainability. Everyone -knows they should comment, so should you. Although we all should probably +knows they should comment, so should you. When writing comments, write them as +English prose, which means they should use proper capitalization, punctuation, +etc. Although we all should probably comment our code more than we do, there are a few very critical places that documentation is very useful: