注释代码的目的有利于代码理解和扩展。
Documenting the purpose of your code makes its intent easier to understand and extend.
不管你的目的是什么，注释代码都不是个好主意。
Whatever your purpose, whole blocks of commented code are not the best way to achieve it.
请看附件，包含了一些笔记和注释代码。
See attached. File contains some notes and the code is commented.
程序员倾向于注释代码块，也许它会需要到。
Programmers tend to comment out blocks of code in case it's needed later.
我们自然会制作一份完善的开发用文档，尽可能多的注释代码。
We'll definitely try to build a solid developer documentation, and to comment the code as much as possible.
注意注释代码和包装器之间的相似之处；这让您感觉到将要写什么样的代码。
Note the similarity between the commented code and the wrapper; that's to give you a sense of what code you're trying to write.
当你熟悉它时，你的代码看起来好多了，没有不必要的注释代码块。
Whenyou are familiar with it, your code looks a lot nicer without unnecessary blockof commented code.
如果想和其它东西一起使用，或者您和我一样是一个健忘的人，您可能会想到要注释代码。
If you're going to be working with others, or if you're just plain forgetful like me, you'll want to comment your code as well.
所以，正如我们所看到的，Meschach代码可被容易地扩展，尽管在理想的世界中应该更加详细地注释代码。
So, as we've seen, Meschach code is easily extensible, although in an ideal world more thoroughly commented code is preferable.
团队成员可以直接注释代码，与代码开发者聊天，并就每一个问题进行协作，追踪错误(bug)并修复缺陷。
Team members can comment directly on the code, chat with the author and each other to work through issues, and track bugs and verify fixes.
可以说，任何好的注释或元数据工具的最大优点是能够使用额外的数据来分析代码。
Arguably, the nicest feature of any good annotation or metadata tool is the ability to use the extra data to analyze code.
任务标记允许您在代码注释中给您自己或其他人留下说明。
Task tags let you leave notes to yourself or to other developers in code comments.
事实上，这个算法出现在该代码的注释中。
这些注释不是代码之中的评论，而只是给其他评审者看的评论。
These notes are not comments in the code, but rather comments given to other reviewers.
首先，我使用了注释来描绘代码的各个部分。
别为烂代码写注释——直接把它重写。
发生的操作虽然很多，但如果熟悉了这些注释，代码将很容易读懂。
A lot happens, but yet once you get used to the notation, the code is self-explanatory.
如果您曾经遇到过带有此类注释的代码，这种情况并不少见。
You're not alone if you've ever come across a chunk of code with a comment like this one.
一些人声称公正的代码注释是好事情，而另一些人声称代码注释只是解释过于复杂的代码的一种机制。
Some claim judicious code commenting is a good thing, while others claim it only serves as a mechanism to explain overly complex code.
清单7的注释帮助您了解代码如何获得结果。
The comments in Listing 7 help you to see how the code arrives at the result.
这将涵盖在注释器的UIMA代码中发生的问题，以及在定制注释器的注释器代码中发生的问题。
This covers all problems that occur in the UIMA code of your annotator and problems that occur in the annotator code of a custom annotator.
顺便说一下，在第一行有一句注释(在代码例子中是源文件的名字)。
By the way, that's a comment on the first line (with the name of the source file for the code example).
例如，我们允许使用源代码注释，其中包括标准的JSR- 250注入注释。
For example, we allow the use of source code annotations, including the standard JSR-250 injection annotations.
在注释器代码中确保创建注释时不超过特定长度是非常有用的。
It may be useful to ascertain in the annotator code that a specific length may not be exceeded in the created annotations.
清单6将展示为各个饼图分区添加注释所需的代码。
Listing 6 shows the code required to annotate the various pie slices.
不要把应删掉的代码注释掉了事我知道有些人重写提交代码的时候，把旧代码注释掉。
Don't comment out code you mean to delete. I have known people to comment out blocks of code they were rewriting and check them in commented out.
最好是注释掉旧代码并对新代码添加注释，这样可以更轻松地跟踪您的修改。
It's best to comment out the old code and add comments to the new code so it will be easier to track your modifications.
通过这些文件中的注释了解代码的作用，或者参考下一节中对代码逻辑的解释。
Review the comments in these files to understand the code or refer to the next section, which provides a high-level description about the code logic.
通过这些文件中的注释了解代码的作用，或者参考下一节中对代码逻辑的解释。
Review the comments in these files to understand the code or refer to the next section, which provides a high-level description about the code logic.
应用推荐