Ep. 22 对话资深文档工程师 Allen Xue：16 年技术文档写作之路

freeCodeCamp 中文播客

今天我们的嘉宾是技术文档领域的资深从业者 Allen。2007 年，他在英语专业毕业后，进入知名的世界 500 强公司。在技术文档还是一个非常新的领域的时候，他接受了专业的技术文档写作培训，接触了先进的系统和工具。后来，他进入创业公司，继续从事资料开发、社区运营和生态治理工作，并且带领团队创建技术文档中心。在节目中，他聊到自己丰富的经历，带我们了解技术文档写作领域的全貌，也分享了关于学习、求职、实践等等经验。

希望你喜欢这期节目，欢迎你关注我们的播客，并把节目分享给更多朋友。也欢迎你发邮件分享自己的故事，也许我们会邀请你作为 freeCodeCamp 播客的嘉宾。你可以在这篇文章中找到邮箱地址。

欢迎在 https://chinese.freecodecamp.org/ 查看更多免费的编程学习资源。

更多关于嘉宾的信息

• 个人简介

主要话题

• 01:36 喜欢看杂书的英语专业生

• 08:00 最初接触技术文档是给游戏写资料

• 12:48 到诺基亚芬兰总部接受技术文档培训

• 17:56 将技术文档作为职业发展理想

• 20:03 从上海回到成都，进入西门子

• 21:47 在 freeCodeCamp 学习前端开发

• 23:36 到美国参加敏捷开发和技术文档写作培训

• 26:23 Doc as Code

• 28:06 大型外企和创业公司中技术文档工程师的工作日常

• 33:58 技术文档写作相关的系统和工具

• 39:37 DITA 达尔文信息类型体系化结构

• 43:20 什么是好的文档，什么是差的文档

• 50:11 如何让文档被用户发现

• 53:00 值得骄傲的技术文档

• 55:03 有帮助的人和学习资料

• 57:33 在思科写市场文档，促成产品销售

• 1:06:58 RISC-V 简介

• 1:09:26 RVspace 生态社区

• 1:15:14 在创业公司中搭建技术文档体系

• 1:21:46 计划/写作/评审/发布/归档全流程

• 1:23:30 国内技术文档从业现状

• 1:25:33 技术文档从业者的薪资

• 1:27:02 最重要的是写作而不是技术

• 1:31:40 英语是一个非常好的工具

提到的资源

• DITA
  
  
• Oxygen XML
  
  
• Git
  
  
• Adobe FrameMaker
  
  
• XMetal
  
  
• RISC-V
  
  
• RVspace 生态社区
  
  
• RVspace、文档中心、软件代码和参考设计等资料的开源仓库
  
  
• 《DITA 最佳实践指南》