mirror of
https://github.com/RPCSX/llvm.git
synced 2024-11-25 12:50:00 +00:00
be explicit about making comments real sentences.
git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@75406 91177308-0d34-0410-b5e6-96231b3b80d8
This commit is contained in:
parent
f5c21ecfa6
commit
b927ca813b
@ -118,7 +118,9 @@ href="mailto:sabre@nondot.org">Chris</a>.</p>
|
||||
<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>
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user