这绝对是主观的，但我想尽量避免它变成争论。我认为如果人们恰当地对待它，这将是一个有趣的问题。
这个问题的想法来自于我对“你最讨厌的语言的哪五件事?”问题的回答。我认为c#中的类在默认情况下应该是密封的——我不会把我的理由放在这个问题上，但我可能会写一个更完整的解释来回答这个问题。我对评论中的讨论热度感到惊讶(目前有25条评论)。
那么，你有什么有争议的观点?我宁愿避免那些基于相对较少的基础而导致相当宗教的事情(例如，大括号放置)，但例如可能包括“单元测试实际上并没有多大帮助”或“公共字段确实是可以的”之类的事情。重要的是(至少对我来说)你的观点背后是有理由的。
请提出你的观点和理由——我鼓励人们投票给那些有充分论证和有趣的观点，不管你是否恰好同意这些观点。
当前回答
生成的文档几乎总是毫无价值的。
或者，作为一个推论:您的API需要为维护者和用户提供单独的文档集。
实际上有两类人需要了解您的API:维护者，他们必须了解您的实现的细节，以便有效地完成工作;用户，他们需要高级的概述、示例和关于他们所访问的每个方法的效果的详细细节。
我从未遇到过在这两个方面都成功的生成文档。通常，当程序员为工具编写注释以提取和生成文档时，他们的目标是介于两者之间的某个地方——刚刚足够的实现细节让用户感到厌烦和困惑，但不足以显著帮助维护者，并且没有足够的概述对用户有任何真正的帮助。
As a maintainer, I'd always rather have clean, clear comments, unmuddled by whatever strange markup your auto-doc tool requires, that tell me why you wrote that weird switch statement the way you did, or what bug this seemingly-redundant parameter check fixes, or whatever else I need to know to actually keep the code clean and bug-free as I work on it. I want this information right there in the code, adjacent to the code it's about, so I don't have to hunt down your website to find it in a state that lends itself to being read.
As a user, I'd always rather have a thorough, well-organized document (a set of web pages would be ideal, but I'd settle for a well-structured text file, too) telling me how your API is architectured, what methods do what, and how I can accomplish what I want to use your API to do. I don't want to see internally what classes you wrote to allow me to do work, or files they're in for that matter. And I certainly don't want to have to download your source so I can figure out exactly what's going on behind the curtain. If your documentation were good enough, I wouldn't have to.
无论如何，这就是我的看法。
其他回答
学校教育毁掉创造力
*“废墟”指“潜在的废墟”
当然，上学是需要的!每个人在使用之前都需要学习一些东西——然而，如果我们不小心的话，你所有关于如何为特定的业务领域采取某种策略的伟大想法都很容易被扔进我们的大脑深处。
当你学习新事物、获得新技能时，你也会把自己的思维定势限制在这些新事物和新技能上，因为它们显然是“做事的方法”。作为人类，我们倾向于听从权威——无论是老师、顾问、同事，甚至是你喜欢的网站/论坛。我们应该时刻注意我们思维运作的“缺陷”。听别人说什么，但不要认为他们说的是理所当然的。对你收到的每一个新信息都要保持一种批判的观点。
而不是想“哇，这很聪明。我从现在开始就用它了”，我们应该想“哇，这很聪明。现在，我如何在我的个人技能和想法的工具箱中使用它?”
Java并不是最好的东西。仅仅因为它带有“企业”标签并不意味着它就好。也不会让它变快。也不是所有问题的答案。
另外，ROR并不是博客圈所吹嘘的那样。
当我在做的时候，OOP并不总是好的。事实上，我认为它通常是不好的。
大多数专业程序员都很糟糕
我遇到过太多为了谋生而做这份工作的人，他们对自己所做的事情很糟糕。蹩脚的代码，糟糕的沟通技巧，对新技术毫无兴趣。太多太多了……
后藤很好!(这足够有争议了吗) 有时……所以给我们选择吧!例如，BASH不需要去。也许有一些内部原因，但仍然。 此外，goto是汇编语言的构建块。没有if语句!：）
一旦发现缺陷就改正。不仅仅是“严重程度1”的缺陷;所有的缺陷。
建立一种部署机制，使用户可以立即使用应用程序更新，但允许他们选择何时接受这些更新。与用户建立直接的沟通机制，使他们能够报告缺陷，将他们的经验与更新联系起来，并提出改进建议。
With aggressive testing, many defects can be discovered during the iteration in which they are created; immediately correcting them reduces developer interrupts, a significant contributor to defect creation. Immediately correcting defects reported by users forges a constructive community, replacing product quality with product improvement as the main topic of conversation. Implementing user-suggested improvements that are consistent with your vision and strategy produces community of enthusiastic evangelists.
