简而言之,技术作家会提供文档以帮助普通读者了解如何使用产品或服务。 我们创建用户指南,手册,白皮书,规格以及其他此类材料。 技术交流(TC)的声誉不佳。 在我们的领域中,很少有人因为他们的著作而声名远扬,而那些人(例如Ted Chiang,Kurt Vonnegut和Amy Tan)以其非技术性工作而闻名。 许多人认为技术写作比创意更偏向于简单,一致和清晰。 然而,正如许多艺术家所指出的那样,创造力源于限制。 技术作家没有把重点放在它的约束上,而是将我们的工作视为交流,告知和增进理解的机会。 毕竟,难道没有简单的优雅,一致的纪律和清晰的无私吗?

也许这看起来很叙事,但是良好的技术交流以及技术作家绝不冷漠。 库尔特·冯内古特(Kurt Vonnegut)著名地指出:“技术作家受过训练,几乎不会在自己的作品中透露任何关于自己的东西。 这使他们成为作家的世界的怪胎,因为该世界上几乎所有其他墨迹斑斑的琐事都向读者揭示了很多关于他们自己的东西。”但是,他接着说:“如果您以任何方式来涂鸦您的想法,您的读者肯定会觉得您根本不在乎他们。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。.。与观众建立同感联系。 作为技术交流者,我们的工作是让自己代替我们的读者,并悄悄地,微妙地表明我们在乎自己。
通常,工程师的任务是为自己的产品编写技术文档。 从表面上看,这似乎是明智的做法—毕竟,谁比产品的创造者更了解产品的内部运作方式? 但是,最熟悉产品或技术的人很少能向普通人解释其使用。 从某种意义上讲,技术作家的任务是成为专业新手。 我们必须像对待第一次一样对待每种产品,服务或技术。 然而,其中仍然存在着技术交流的巨大悖论:即使对于初学者来说,我们的文件也必须简单易用,但我们必须以传达信心和权威的语气来撰写。 技术作家必须能够像读者一样看待事物,同时仍要全面了解我们的主题。 这不是一件容易的事。
技术作家通常来自不同的背景,包括科学,IT,语言学,文学等等,并且拥有各种各样的技能。 泰德·蒋(Ted Chiang)所描述的“渴望清楚地解释一个想法”比什么都重要,这使我们团结起来。虽然技术交流确实缺乏魅力,但对于那些对语言充满热情的人来说,这很容易在其中找到一个真正的呼唤。 如果您有任何共鸣,也许您应该考虑从事技术写作。
由 CSOFT International的 技术作家Samuel Rosenberg撰写
阅读更多 Samuel Rosenberg的博客