与大一学生关于技术文档工程的交流 | 技术传播
▶ 本文内容完全由作者撰写,无任何AI辅助创作
大家好,我是热衷分享,但不好为人师的技术传播者睿齐。
节前收到1位理工科专业大一学生的私信,说自己在“认真探索技术文档工程师方向”,读了我早年写过的几篇文章后,提出了4个问题。
我的第一反应是:现在的大一学生,都已经这么厉害了吗?早早地探索职业方向,阅读前人经验分享,主动建立联结,提问层次清晰,用词礼貌得体……行动力满分。
回想起自己的大学时光,简直是:搞什么鬼?想着想着,竟不自觉地满脸红温起来。

感谢这位同学的信任,你的问题对我而言,同样是启发思考的过程。
认真的提问,值得真诚的答复。在此仅基于本人有限认知和实践,分享一些个人思考,希望可以给到你的探索,一点点启发和帮助。

问题1:关于与研发的沟通场景
文档工程师在实际工作中的沟通场景并不相同,与他的【岗位职责】和【项目目标】有密切关系。比如:
-
如果你主要负责产品文档的开发与交付(偏【开发】角色),那么你需要与研发团队密切配合;
-
如果你主要负责运营开发者社群(偏【FAE】角色),那么你可能更多是在与产品和用户沟通;
-
如果你主要负责内容策划,协调内容输出(偏【产品/项目】角色),那么,即便你依然是与研发沟通,但是沟通的内容,可能会从具体的产品、技术细节,转变为项目跟踪;
-
如果你乐于探索文档开发系统的部署建设(偏【产品研发】角色),那么你可能还要做与产品技术调研有关的行业沟通……
所以,对于【文档工程师】而言,没有一成不变的沟通场景——尤其是在AI时代,【文档工程师】的岗位职责变得愈加凌乱、飘忽不定——至少个人感受是这样的——需要结合具体的【岗位职责】和【项目目标】做具体分析,灵活应对。
假如你是1个软件类技术文档的开发者(开发角色),那么典型的沟通场景供参考:文档开发过程中,TW如何与研发高效沟通? | 技术传播
具体到我本人的话,目前在初创企业做【文档主管】,或者也可以称作【一人文档部】,集全栈角色于一身——本质上,就是个【打杂的】:
-
产品:负责策划文档和内容开发;制定相关流程规范、文档开发系统建设;
-
项目:协调相关责任人(产品/研发/测试/FAE)输出相关内容;跟踪任务进度;进行版本管理;
-
开发:通常相关责任人输出的内容可视为【初稿】,需要进一步完善,包括但不限于内容优化、Word排版、编译错误排查等,以达到交付质量标准;
-
QA:判断文档的内容质量是否满足用户的信息需求,如不满足,则给出反馈,迭代优化;
-
其他:文档涉及的方方面面简直不要太多。
所以,在整个文档工程过程中,需要灵活沟通的非典型场景,实在太多了。
问题2:关于研发不配合;关于文档没人看
1)关于【研发不配合】,个人以为,本质上是【工作边界】的问题。
大家都是出来混的,彼此之间能有啥私人恩怨?都是为了达成项目交付目标。如果说过程中发生矛盾,无非是在【你做还是我做】上出现了分歧。这种情况下,我通常会直接选择【后者】——文档交付,是所有软硬件产品交付中,最轻量的一环,矛盾最易解决,不值当纠结。
2)关于【文档没人看】,个人以为,是个最常见的误解。
从产品的思维来看,当1个文档被定义出来,就是因为【有人看】——是为了解决特定场景的信息传递问题。
为什么会存在【文档没人看】的情况?很大程度上是因为文档质量无法满足用户获取和使用信息的需求。
文档之所以会存在,其核心价值在于,它解决了【思维逻辑显化】【知识积累】和【高效沟通】这3个非常重要的问题。详细说明戳>>日常工作和学习中的3个写作逻辑 | 技术写作什么鬼
尤其是在AI时代,AI知识库的建立,强依赖于文档输出;AI获取和组织信息的水平,强依赖于文档质量。所以,文档不仅要【给人看】,未来还要【给AI看】。

问题3:关于专家路线
正如所言,【文档工程师】岗位确实存在【门槛低、天花板低】的情况。
个人认为,1个传统意义上的【文档工程师】典型成长路径是:
-
初级:学习使用文档开发工具;在指导下完成技术内容写作;
-
中级:熟练使用文档开发工具;能够独立完成技术内容写作;
-
高级:对内容架构有深刻了解;能够独立进行文档内容策划;
-
主管/一人文档部:需要具备较高的综合能力,包括但不限于:
-
专业技能:内容管理、文档工程管理
-
通用技能:产品思维、项目协调管理
随着近年来AI快速发展,对于【文档工程师】的职业路径冲击较大,基本上等同于对【研发工程师】的冲击——是极具颠覆性的。具体到我们公司,曾经招聘过1位【文档实习生】,但最终也没有留用;现在基本全靠AI辅助下的自我提升。
听起来很像是个很恐怖故事?是的。虽然你还只是个涉世未深的大学生,但我并不想因此骗你,让你产生不切实际的期待;同时,也想跟你分享一下我个人的乐观思考:
最近有个流行语叫做【一人公司】,你可能听过?恰恰是因为【文档工程师】具有这种【打杂】属性,所以在AI时代中,非常具有【一人公司】的潜力。当你有能力一人挑起整个部门的繁复事务,有能力协调一群人达成目标的时候,理论上,你完全可以选择面向【客户】提供服务,而不仅仅只服务1家【公司】,关键是,要找到自己能够对外输出的【价值点】。
如何走通专家路线?个人浅答,仅供参考:
-
做好本职工作,提升专业技能;
-
扩大能力边界,提升通用技能;
-
过程中:
-
对内:尝试个人知识管理,做好知识和经验的积累,实现知识复利;
-
对外:尝试采取写文章(书)、开源代码、发布演讲等形式输出价值,逐步形成个人IP,扩大影响力;
-
积累即便脱离平台,也能独立成事的实力和勇气。

问题4:对于大一学生的建议
我不是很喜欢给人建议,只是分享一些个人思考。
前段时间参加了一个AI主题的读书会,恰好有过一些思考和总结:观点:在AI时代,对人来说什么能力更重要 | AI实践
在AI时代,没有人知道未来将会成为什么样子;但是无论如何,我都更希望你拥有健康的身体,和预约的心情——因为我们付出的一切努力和辛劳,最终都是为了可以更好地生活。
今天的分享,就是这些内容。如果你喜欢这篇文章,觉得有所启发和帮助,记得点赞和分享;如果对这个话题感兴趣,或者有不同意见想要表达和交流,就留言告诉我吧。

其他推荐:
AI辅助编程:Sphinx文档工程自动化发布脚本 | 技术传播
实施:GitHub + MarkDown 文档系统的工作环境部署及工作流程说明 | 技术传播
在座都别吵了,你们还有我 | 技术传播

睿齐
技术传播者
自由摄影师
知识管理实践教练
品牌内容策划
汪力迪
公众号:techcomm / htstory
微信号:bgrichi
邮箱:hash_0813@163.com

夜雨聆风
