be explicit about making comments real sentences.
llvm-svn: 75406
diff --git a/llvm/docs/CodingStandards.html b/llvm/docs/CodingStandards.html
index dbe95a8..79c816e 100644
--- a/llvm/docs/CodingStandards.html
+++ b/llvm/docs/CodingStandards.html
@@ -118,7 +118,9 @@
<div class="doc_text">
<p>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:</p>