
Doc as Code
文章平均质量分 92
大龙谈智能内容
龙景军,曾为中国商飞、美联航、欧洲直升机公司建设结构化文档系统。摩拿科技CEO,公司从事DITA结构化文档系统咨询、培训和建设。自研MxDoc,代理Oxygen XML Editor&Arbortext+技术服务。做好文档,让你的产品好卖。
联系加我微信:jingjun_long
展开
-
Doc as Code (4):使用Git做版本管理,而不是使用目录做版本管理
用目录来管理版本被使用了很久,这篇文章说说怎样使用分支替代用目录来管理版本。原创 2023-11-08 22:31:50 · 679 阅读 · 0 评论 -
Doc as Code (3):业内人士的观点
Doc as Code是应用软件开发流程和工具来交付技术文档。它使用与开发团队相同的工作流程和工具,包括版本控制系统、自动化测试、问题跟踪器等。它还依赖于轻量级文件的生产和管理。Doc as Code相当容易获得且易于使用。需要的工具是极简的,通常是免费的,并且像文本编辑器一样简单。Markdown 或 AsciiDoc 等轻量级格式是开始使用Doc as Code的最快方法,因为它们都可以处理纯文本文件。与任何技术范例一样,Doc as Code有其优点和缺点。优点它促进TW和开发人员之间的合作。原创 2023-07-30 08:44:33 · 312 阅读 · 0 评论 -
Doc as Code (1):起源
这里的Doc应该翻译成“写文档”而不是“文档”,Code应该翻译成“写代码”而不是“代码”,这样Doc as Code翻译成中文是:像写代码一样写文档。所以“文档代码化”这个翻译大龙觉得并不太准确。Doc as Code起源于软件行业的文档,是指用开发人员编写代码和发布软件相同的工具和流程来编写和发布文档。写代码是软件工程师的主要工作,软件工程师更愿意把他们的时间花在研究需求、算法、编写和调试代码等软件开发活动上。其他工作则是能“偷懒”就“偷懒”。原创 2023-07-15 09:48:10 · 654 阅读 · 0 评论 -
Doc as Code (2): 从软件工具链到文档工具链
从软件工具链聊到Doc as Code的文档工具链。原创 2023-07-19 22:24:58 · 349 阅读 · 0 评论