程序员的十大烦恼(2)

　　6. 写文档

　　在说这个条目之前我先承认，我们确实有很多的文档生成工具，但据我的经验，这些工具都是只适合生成API文档，以供其他程序员参考。如果你开发 的软件是平时人们每天都要用的，你必须要写一些外行人(例如你的实施，客服等)都能理解的文档手册。

　　我们可以很容易的看出，有些事情程序员们极不愿意去做。 你可以简单的回顾一下所有的开源项目。 人们百折不挠的对这些项目的一个索求是什么：文档。

　　我敢打保票的说，不管在哪里，至少会有一半的程序员当要求写文档时会说：“不能让其他人去写吗?“。

　　5. 程序 — 缺少文档

　　我可从来没说过我们程序员是说一套做一套的人。

　　程序员们经常会在他们的项目里用到第三方的类库和应用。 于是，我们需要文档。 很不幸呀，就像我在第6条里说的那样，程序员们痛恨写文档。这戏剧性的事情发生在我们自己身上。

　　当你需要使用一个第三方类库时发现，至少有一半的API无从知道是干什么好用的，没有任何事情比这个更打击人的了。 函数 poorlyNamedFunctionA() 和函数 poorlyButSimilarlyNamedFunctionB() 有什么区别? 在我使用 PropertyX 属性前是否需要测试一下它是不是 null 值?我估计只有通过自己的测试和报错才能弄清楚!可恶。

　　4. 硬件

　　任何一个曾经被叫去调试一个数据库服务器上奇怪的宕机现象，或是被叫去解决RAID驱动器不能正确的工作的问题的程序员，当发现是硬件问题时， 都会痛苦不已。 人们有一种普遍的误解，认为程序员就是搞电脑的，他们肯定知道如何修理电脑。 不可否认，有些程序员确实是个全才，但我估计，绝大部分程序员都不知道，或者根本不关心当程序被编译成机器码后如何工作的。我们只关心做出来的东西是否符 合需求文档，这样我们才能集中精力去解决这上层的任务。

　　3. 含糊不清

　　“网站宕机了”. “XX功能工作不正常”。 处理含糊不清的任务是种痛苦。 每次当非程序员被要求重现他们所遇到的问题时表现出的愤怒都让我吃惊不已。 他们似乎不太明白，仅仅一句”它宕机了，修复它!”是无法让我们开始工作的，我们需要更多的信息。

　　软件的运行是(大部分情况下)有迹可寻的。我们也乐见与此。 请迁就我们，帮我们指出是在哪个阶段，什么情况下出的问题，而不是简单的说一句”修复它“。

　　2. 其他程序员

　　程序员经常和其他程序员合不来。诧异吗，但这是真的。 这方面的事情我可以轻松的列出十大条，讲细点甚至可以单独写篇博客，所以这里我只列出几个常见的、让其他同事感到懊恼的程序员的特征：

　　脾气暴躁以至态度极不友好。

　　不能明白什么时候该去讨论系统的架构，什么时候是应该去动手去做。

　　无法进行有效的沟通，使用易于误解的专业术语。

　　自己的事情处理不好。

　　对要做的程序和项目缺乏兴趣。

　　那么，这最后的，但不是最糟糕的，序号为1的让程序员们烦恼的…

　　1. 自己写的代码 — 6个月以后的

　　Don’t sneeze, I think I see a bug.回顾一下自己以前写的代码，是否也会愁眉苦脸?当时怎么会这么愚蠢!怎么能编写成这样的东西! 烧掉!丢到火里!

　　哈，好消息。你并不孤单。

　　现实是，软件技术界是一个不断变化的世界。 今天被看成是最好的方式，明天也许就会过时。 我们不可能写出完美的代码，因为判断我们的程序好坏的标准日新月异。 这令人很不爽，你的作品，今天看来是那么的完美，但也许不久之后就会变成被人嘲笑的对象了。 真是让人沮丧，因为不论我们如何努力的学习最新最棒的开发工具，设计，框架，以及开发方法，我们总是比最新的技术发展趋势慢了一拍。 对于我来说，这是做一个程序员最苦恼的事情了。我们不断的升级技术，是为了让软件更好，但却禁不住感到，我就像一个做沙毯(sand-painting)的和尚。

　　好了，全都给写出来了。这十大让程序员烦恼的事情。 依旧，如果你觉得我的文章里有什么疏漏的地方，请让我知道，欢迎留下评论!

原文转自：http://www.vaikan.com/top-10-things-that-annoy-programmers/