红帽在捷克马萨里大学开展技术写作教学实践
红帽(Red Hat)位于捷克布尔诺的大型办公室与当地马萨里大学信息学院合作,共同培养未来的技术文档撰写者。在布拉格举行的开源峰会(Open Source Summit)上,红帽布尔诺文档团队资深成员 Jiří Herrman 发表了题为“图表与龙:以开源方式向大学生传授技术写作”的演讲,分享了这一合作项目四年来的经验与教训。

布尔诺是捷克第二大城市,也是马萨里大学的所在地。过去四年间,红帽一直与该大学合作开设编号为 PV177 的技术写作课程单元。Herrman 指出,尽管红帽致力于通过该项目培养人才,但课程启动曾因“2020 年全球性的……那个事儿”而推迟。该项目的核心目标之一是解决技术写作中“棘手的一部分”,即如何真正与其他人进行互动。
教学方法的调整与挑战
Herrman 在演讲中回顾了课程导师从学生身上学到的经验,并指出了几种行不通的教学方法。尽管课程面向具备一定技术知识的学生,但使用基于 Shell 的工具布置课堂作业效果不佳。原因包括部分学生从未使用过命令行、借用笔记本电脑缺乏管理员权限,或仅携带手机而非电脑上课。
此外,模仿专业技术作家互审稿件的学生互相评分机制也未能奏效,主要受限于所需的速度以及人际关系的复杂性。最终达成的妥协方案是专门教授学生如何互相评分,“同时不惹恼彼此”。另一项令人意外的发现是,与在线授课且每节课更换不同导师的远程教师互动效果较差。
应对生成式 AI 的使用策略
随着大语言模型(LLM)的普及,AI 的使用成为 2023 年首次开课时的最大挑战。虽然课程规定学生不得使用 LLM,但实际使用中难以完全禁止。Herrman 报告称,对涉及 LLM 使用的优秀作品给予表扬会鼓励更多作弊行为,而批评学生则会打击积极性,同样可能助长作弊。
为此,团队调整了策略,转而教导学生如何正确使用 LLM。有效的激励手段包括发放积分(即使有时带有半随意性)、偶尔设置秘密奖品,以及通过互联网风格的梗图(meme)提供反馈。
开源材料与职业前景
课程的最终练习采用“龙与地下城”风格的情景角色扮演,主题为“我想成为一名技术作家,但该如何实现?”。学生需协调跨职能团队,创建发布说明、技术笔记以及流程的实际文档。
由于课程材料是开源的,毕业生最终获得了一份永久的 FOSS(自由及开放源代码软件)记录,可用于向潜在雇主展示能力。该项目设有 GitHub 仓库,公众可查看 2025 年和 2026 年部分学生的存档课程作业。
关于 AI 时代技术写作中的 LLM 使用问题,也是 Herrman 此前主持的一场“同类相聚”(Birds of a Feather)会议的主要议题。他在会议上询问观众有多少人正在其技术写作工作中使用 AI,得到了他所谓的“绝大多数”已经参与的回应。





