文档:放弃吧;不会发生的。

作者:Tom Adelstein

曾经,在不久之前,我自认为是一个不错的系统管理员,拥有体面的简历和工作经历。当我完成一系列包含系统管理技术主题的写作任务后,我认为是时候在一个同时使用Linux和MS系统的公司工作了。

我把我的简历放到了Dice和Monster上,等着电话铃响。当电话没响时,我上去看了点击量。我在Monster上看到了六次,在Dice上看到了八次。只有一家公司保存了我的数据。

我不知道是什么驱使我制作了一份技术写作简历,但我确实做了。我有足够的经验,并且我编写了无人“抽空”编写的白皮书、用户手册、政策和程序指南、S-1 SEC注册章节等等。在Monster上,我立即开始获得点击量——一周内大约164次。在Dice上,这个数字大约是186。我切换回了我的系统管理员简历,再次我获得了四到八次点击量。这与我的经验相悖。

正如JBoss的一位朋友曾经说过的那样,“得吃饭”。所以,我开始接受短期写作任务。我了解了该领域的几件事。除了Sarbanes Oxley、HIPPA、SAS70和数据仓库等的大量文档需求之外,许多公司还留了一手。他们招聘技术作家,但他们真正想要的是可以用30-35美元/小时的价格获得的商业和系统分析师。

我还没有看到任何职位需要检查语法、拼写和业务规则的内部作家。未来的雇主想要有UML、EDM、Visio和MS Project经验的人。他们还希望有人能够将一个没有文档的软件应用程序还原到其原始规格。职位要求:重新设计一个从未有过功能或技术规范的正在运行的应用程序。

我在一些非常大的公司做了两个这样的项目,发现文档方面存在巨大的差距,如果存在任何文档,那就是缺乏更新。这让我开始思考我尝试修复和记录一些流行的开源项目的经历。如果拥有大量资源的大公司都忽略了他们的文档,那么我们能对几乎完全是程序员的社区抱有什么期望呢?

开源文档与公司界有很多共同之处。在我的最后一项任务中,我发现了一个庞大的wiki群体。每个部门至少有一个。曾经有人维护这些信息库,但几乎所有这些信息库都空无一人地坐在内网上,被遗弃了。我问人们是否知道他们部门的wiki,我发现只有一个人甚至知道它的存在。她每天都在维护它。

提供Linux文档是否是一项无法克服的任务?我开始这样认为了。主要的科技图书出版商已经放弃了招募作者和出版系统管理书籍的努力。相反,他们已经开始将大部分注意力集中在编程上。谁能责怪他们呢?为了吃饭,他们必须出版那些销量足以支付成本并提供一些投资回报的书籍。这种情况现在并没有发生。

我并没有感到沮丧,也没有建议您或任何其他人停止发布信息供他人查找。我只是认为这项工作比我和几乎任何其他作家都更重要。技术写作专家的全盛时期已经到来,并且存在短缺。我只是很高兴我上了约翰斯顿小姐的英语课,在那里我被留校了很多次,这样我就可以放学后和老师一起呆着。

加载Disqus评论