工程

投资内部文档:创业公司的一砖一瓦指南

这是半夜,当值班工程师被他们的手机闪着光和一连串推送通知、短信和电话吵醒时。生产服务器宕机了,他们负责尽快恢复。这位工程师眼睛迷糊,头脑模糊,疯狂地在Slack、谷歌Docs和GitHub上搜索答案,但他们只模糊地提到了这个错误。由于没有任何有意义的信息,他们被迫焦急地等待一位资深工程师醒来,而停电仍在持续。

关键任务知识困在早期雇员的头脑中是一个非常常见的问题,初创公司的工程组织非常了解。但是,投资内部文档通常是一个先有鸡还是先有蛋的问题。在刚起步的创业初期,当你获得有价值的知识并规划你的路线时,有一个绝佳的机会把事情写下来。每个新加入的员工快速承担大量责任,这些文档是快速启动和运行的关键资源,而不会减慢业务节奏。

但是,由于待办事项清单长得令人难以置信,团队规模又小,抽出时间来记录这些经验教训很快就变成了愿望清单,而那些最好的计划往往会消失。把这些重要的见解放在次要位置,就会随着时间的流逝而消失。

作为Stripe、Uber和Salesforce等公司的早期文档领导者,大卫Nunez目睹了这样的循环一次又一次地重复——他经常被任命来清理内部文件债务。(本着实践你所宣扬的精神,努涅斯甚至写下了他的教训,与人合著了这本书。开发者文档,一本技术写作手册。)

像Stripe这样的公司已经让令人愉快的开发者文档成为拥挤市场中的秘密武器之一。但努涅斯反复看到一个普遍的模式,困扰着所有类型的初创公司。“很多早期员工成为了公司的英雄。他们构建了许多功能,解决了主要的中断,并提出了改进基础设施的新方法。随着公司的发展,越来越多的人加入公司,没有书面记录的情况下,那些守旧的人会受到问题的轰炸。这造成了一个恶性循环,新员工迅速意识到得到答案的最快方法就是去问那些守旧派,”努涅斯说。”突然间,这些早期英雄最初提供的所有价值,即建造和运输,现在他们的时间更少了.”

另一个常见的陷阱?由于文件的本质是内部的,因此很难借鉴其他成功公司的既定剧本。像Stripe和亚马逊以其写作文化而闻名那些有前途的创业公司都很羡慕——但如果你想复制他们的方法,没有明确的路线图可以遵循。

“从本质上来说,模仿其他公司在这方面做得很好是很困难的,因为文档隐藏在内部。相反,你的CEO会见了Stripe或亚马逊(Amazon)的领导者,然后回来说,‘文档非常重要——我们将专注于它。“他们的意图是好的。但没有明确的、切实可行的方向或后续行动。”

当创始人要求将更好的文档作为优先事项时,你就需要有人来实际模拟成功,并在第一线指导实施。否则,你就只能在几个月后放弃零碎的努力。

需要明确的是,Nunez并不是只针对早期或中期的创业公司,大公司也可能因为创建了一个文件等级系统而感到内疚。“如果你去任何有意义的长期成功的公司,他们至少会有尚可接受的外部文档,比如入职指南或故障排除说明,因为用户依赖它。但是你一次又一次地看到,企业公司有100名技术作家和20人的工程团队在外部文档上工作,但没有人在内部文档上工作,比如解释系统架构是如何工作的,”Nunez说。

在这次独家采访中,Nunez概述了创建良好内部文档卫生文化的具体步骤。作为Uber首位专职文档员工,以及Stripe首位文档内容主管,他借鉴了自己的经验,就招聘过程的每个部分分享了超战术建议:从养成习惯、激励工程师付出努力,到保持工作的有条不紊。虽然他的指导是专门针对没有专门文档团队的初创公司的,但对于那些偏离了轨道、想要纠正错误的大型组织,他也有很多策略。

如果您把赌注押在文档上,那么您公司成长的下一阶段将极大地受益于捕获这些知识内核,否则这些知识内核将会湮没在茫茫宇宙中。

第一步:从文化转变开始。

文档通常被视为一个可有可无的东西——一个你可以一直踢到“你有空闲时间”的罐子,或者更糟的是,直到出现严重的停机迫使组织不得不考虑它。Nunez说:“很多时候,当一些可怕的事情发生,事情完全错误时,人们会意识到需要文档资源。

优步现在以在一个新城市推出服务时精心部署的内部剧本而闻名。员工可以在一个没有优步足迹的城市落地,手里拿着一本剧本,里面满是优步在旧金山和纽约运作良好的文件。但是,尽管取得了这些早期的胜利,该公司还是得到了一个痛苦的警钟,他们需要在内部文档方面投入更多。

努涅斯说:“在优步,我们开始关注文档和收集一些资源,但工程团队的发展速度远远超过了文档团队的发展速度。“后来,由于中国的一个数据中心过热,出现了停机。一名工程师按照运行手册中的步骤进行了操作,结果却让故障变得更严重,数据中心完全瘫痪了。”

一项根本原因分析发现了一个不太可能的罪魁祸首。“跑步簿不准确,列出的步骤顺序也不对。运行手册显然写得非常马虎,这让领导层意识到我们需要掌握我们的文档标准,”Nunez说。

似乎最直接的解决办法就是雇佣人手来解决问题。但是,Nunez建议采用另一种方法,而不是启动招聘冲刺来寻找你的第一个文件雇员。“默认情况是,公司在文档编制方面资源不足,这当然会导致文档编制薄弱。但我也看到一些公司确实在文档上砸了很多钱,但没有在正确的领域或采用正确的方法,所以工程师们不经常使用文档。”

我不建议创业初期就去找一个全职的文档写手.我了解到,尤其是在高绩效的环境中,改变企业文化是你能做的最高杠杆投资。”

如果您首先解决编写和维护文档的激励和奖励(或缺乏激励和奖励),您将很快看到有意义的进展。

改变企业文化似乎是一个复杂问题的模糊、含糊的解决方案。但是Nunez概述了开始的两个关键步骤:

树立良好的写作习惯。

没有强大的写作文化,就不可能有强大的文档文化.我发现,要将这一点融入企业文化,最有效的方法就是确保领导者,从创始人到一线经理,认真对待自己的写作努涅斯说。

我见过一些高管写的电子邮件都是小写字母,充斥着缩写和错别字,这给人的印象是,他们写一封低质量的电子邮件所节省的时间比别人破译它所花费的时间更有价值。不仅人们会对糟糕的可读性感到沮丧,而且其他员工也会学会不把写作当回事。

试试下面这两个习惯:

定期回顾。“对于领导者来说,提高和展示他们的写作和知识分享技能的最有效方法是更认真地做会议记录和跟进。分享你自己在会议上的行动项目和收获,会激励其他人效仿这种行为。”

获得生存。“你最近学到了什么?”你对目前公司的目标有什么看法?你们最近在战略上做了哪些调整?定期分享自己的想法提供了重要的背景,也加强了写作和分享知识的重要性,这将渗透到组织的其他部分。”

养成编辑的习惯。

“回到学校,你通常有答题组,当考试是多项选择时,他们很高兴。然后是报社的工作人员,他们很高兴能写一篇文章。通常情况下,这是非常两极化的,”努涅斯说。“那些不认为自己是伟大作家的人往往写得越来越少,而且害怕自己的作品被批评。”

但编辑对写作过程至关重要——无论你是天生的散文高手,还是在学校总是害怕写论文。“多年来,每个职业作家的作品都被教授、同事和同行批评过。他们接受这只是写作过程的一部分,以产生高质量的东西。让别人批评你的写作是一个很脆弱的处境,但练习写作并获得反馈是提高写作水平的唯一途径。”他说。

我的一位前工程领导曾经说过,“黑客和软件工程师之间的主要区别之一是记录工作的能力。”

英国人想提高他们的写作能力,努涅斯建议进行一些逆向工程。“寻找内部或外部的优秀作品的例子,并试着诊断为什么它如此有效。他们是如何如此清楚地传达信息的?他们是如何很好地吸引你的注意力的?语言是否简洁?他们写了吸引人的介绍吗?努涅斯说。

当您在处理自己的文档时,尝试引入一个测试用例。“一个简单的练习是把你的文件草稿交给同行,并让他们解释他们读到的内容。如果他们感到困惑,你知道你还有工作要做。如果他们理解了你想要传达的关键点,你就完成了你的目标。”“不要太执着于成为一个天生的作家——专注于成为你自己作品的伟大编辑。”

让写作成为工作阶梯的一部分。

许多领导者急于修补有缺陷的内部文档,直接采取策略——试图建立一个完美的流程,将文档烘焙到软件开发周期中,或者更换一个工具,希望它能解决问题。

相反,要从更上游的方面着手:招聘和招聘促销活动流程.努涅斯说:“我发现,如果你把分享知识的期望写进工作描述和工作阶梯中,人们自然会希望在自己的阶梯上履行这些职责。”

通过反复试验,他现在提倡从这一步开始您的文档工作。“Uber一度在修改软件工程的层级。我能够与领导刷新工作的工程师合作,我们将文档期望放在每个级别。一夜之间,人们来找我们说,‘我想满足人们对我的角色的期望。我能做些什么来满足这些要求努涅斯说:“这就像一个灯泡熄灭了一样。”“所以当我加入Stripe时,我在第一周就迈出了这一步。我在每一级的工作阶梯上都写了一行文件’”努涅斯说。以下是他的建议,你可以在自己的工作阶梯中借鉴:

IC应届毕业生:确保您的代码有良好的文档记录,并带有有用的代码注释和readme。

高级集成电路:确保您的服务和系统有良好的文档记录,有图表和端到端指南。

Eng领袖:确保你的团队有完善的文档实践,从代码评审到事件评审。

现在有了绩效考核和晋升机会,人们开始优先考虑这类工作。“我很快就看到了许多不同的文档想法和项目,我自己不会考虑从工程组织中产生的——比如构建一个Slack集成,在提出问题时自动建议相关文档。只要告诉工程师,‘这很重要——你正在为此进行评估。’然后看看会发生什么他说。

努涅斯还提出了另外两个战术想法,供球队尝试:

即使在业绩考核季之外,也要成为焦点。“一位经理在她发送的每周更新中都包含了他们的‘每周医生之星’。把别人叫出来是一件很容易的事情,人们都喜欢被认可——尤其是在他们做的事情超出了他们的舒适区。”

挤出时间。他还见过其他团队做“文档突击”(比如bug突击),整个团队会花一天,甚至一周的时间来处理文档。“制作排行榜,看看工程师们是如何积极地做出贡献的。”

第二步:开始用MVP方法偿还你的文档债务。

即使在文化转变的过程中,您可能仍然面临着在数月(或数年)优先考虑这项工作后积累起来的大量文档债务。这可能感觉就像让一辆16轮货车突然掉头。

努涅斯建议逐渐在这个弯道行驶,这样卡车就不会翻车了。首先确定要处理的最关键的主题。“向工程师们发送一份调查,或者查看Slack中出现的最常见的内部问题。你可能会有100多个主题,这些主题都有工程师们抱怨的糟糕文档,但在一开始,你必须将大部分资源集中在一个更窄的焦点上。试着找出工程师们最头疼的5到10个技术课题,然后投资于这些课题他说。

不要一味地假设人们需要什么。努涅斯说:“当我们在优步开始这项工作时,我们查看了内部数据,看看工程师们最喜欢搜索什么,这些数据真的让我们感到惊讶。”

专注于工程师每天真正需要的东西,而不仅仅是你手头的技术认为他们需要支持。

“我们发现,工程师们正在为一项必须用于服务器配置和管理的神秘技术而苦苦挣扎。在较大的公司,你会有一个运营管理人员或专家团队,他们在这个软件方面有专业知识,但在启动阶段,每个工程师都需要在某个时候使用它来部署更改。这对他们来说很可怕,因为如果工程师做出了错误的更改,他们可能会导致服务的大规模中断——而且他们经常这样做,”努涅斯说。“我们确定了这一需求,加强了文档,纳入了反馈,并立即看到关于这一主题的抱怨下降,以及在中断事件的根本原因分析中大幅减少对该软件的提及。”

大卫·努涅斯的照片
David Nunez, Stripe和Uber的前内部文档负责人,《开发者文档》的合著者

注重质量,而不是数量来设定标准。

作为奖励,通过确定最关键的主题,您将更快地取得更有意义的进展,并开发组织中的其他人可以模仿的高质量文档示例。“当你开始关注文档时,工程师们会说,‘我以前从来没有做过这个。给我举个例子。通过在更少的高质量资源上投入更多的努力,你就能向人们展示什么是“伟大”。你会很快提高底线,”他说。

很多时候,创始人告诉我,“我甚至不知道从哪里开始写文档,这太糟糕了。”当我告诉他们专注于一个其他工程师可以复制的好例子时,他们松了一口气。

他分享了在优步工作期间建立肌肉记忆的一个例子。“一开始,我们只是从一个简单的文档开始,告诉你如何设置你的环境和开发盒,这样你就可以开始提交生产代码了。这是每个新工程师都必须做的任务,如果没有文档,人们只是坐在房间里帮助新工程师手动完成。”

Nunez说:“一旦我们帮助该团队创建了一个清晰的入门指南,该指南组织良好,易于阅读,我们就能够将其作为其他希望偿还文档债务的团队的黄金参考。”开始编写文档的其他思路包括:

代码风格指南:“标准化你的编码风格可以减少开发和代码审查期间的认知开销,并创建一个更干净的代码库。”

术语表:“每个公司都有自己的系统和服务术语。创建词汇表是为重要定义创建真相来源的一种简单方法。”

扮演一名记者。

像设置开发环境这样的简单主题可能相当简单。但是其他的(比如Nunez之前关于神秘服务器管理技术的例子)可能要复杂得多。努涅斯建议,与其去寻找夹杂着电子邮件、Slack信息和电子邮件的过时备忘录碎片,不如找到一个真相来源。

“我们会和最了解这个话题的人坐下来,在白板上写下主要观点。然后,文档作者就会有一个文档的起源,可能还有一些其他工程师的名字作为更多信息的线索。很快,你就可以发布一个工程师可以依赖的文档集,这在以前是不存在的,”Nunez说。“我们有一个作家,她很快就写出了文档,因为她会记录下与工程师的会议,把音频转换成文本,然后稍微清理一下,然后发布,然后再转向下一个文档。”

你也可以把同样的做法应用到更复杂的文档制作上:“在Uber,我们没有规范的文档或图表来说明我们的服务架构是什么样的。事物的发展和变化如此之快——人与人之间的描述是不一样的。这是有问题的,因为当你不知道所有部件是如何组合在一起的时候,你就无法构建安全性和可靠性。”

“一开始,我们请了一位知识渊博的终身工程师在白板上提出理论,并描述事情是如何发展的使用去工作。然后我们以此为基准,寻找其他可以帮助填补空缺的人。在几周内,我们就有了一个关于架构的非常好的文档,同样重要的是,我们有了一个让工程师理解系统的精确图表。”

优秀的文档作者就像记者一样——跟随线索,填补空白,写出完整的故事。

授权给你的高级工程师。

当你从文档债务中爬出来时,Nunez强烈建议让资深人士加入,而不是在团队中指定一个人作为文档代理。

“教育你的高级工程师,倾听他们需要什么来帮助建立强大的文档文化,并保持对话以维护这些新规范。让高级工程师在架构讨论和代码审查期间执行文档标准是在开发生命周期中巩固文档的好方法。很快,它将变得如此普遍,以至于工程师们甚至不再认为这是一个额外的步骤。新加入的工程师也会很快跟进。”

我曾参与过各种类型的剧本计划,将文档编入开发过程,但最有效的是调动高级工程师。他们知道文档的重要性,但往往没有意识到他们有一个声音和平台来让其他人跟随。

第三步:停止文档的随机行为,变得有条理。

养成把东西写下来的习惯只是战斗的一半——以一种合乎逻辑的、易于搜索的方式组织你的文档是工程团队面临的另一个绊脚石。如果没有一致同意的组织系统,你会发现自己的文档越来越多,而不知道哪些是最新的和准确的。

“这对很多团队来说都是可怕的,因为这已经与写作无关了。现在你必须弄清楚人们是如何找到它的。我了解到,对工程师来说,上信息架构的高级课程是非常困难的。他们甚至不想开始,因为他们意识到他们无法想象最终的状态是什么样子,但他们知道这将是一项艰巨的工作,”努涅斯说。

但是策划和组织内容可能是一个重大的胜利——特别是对于那些对文档是否应该优先考虑的组织来说。“如果你首先专注于管理,而不是试图写大量的新文档,你可以在相对较短的时间内产生如此广泛的影响。你不需要太多的背景来做得很好。盘点现有的内容,合并重复的内容,删除过时的内容,清理和更新一些重要的内容,然后将其组织成一个整洁的结构,”Nunez说。

这些可能看起来只是外观上的改变,但它们可以为你的钱提供一个大爆炸。他说:“它允许工程师更容易地找到和理解重要的文档,这些文档将立即显现出来并提供即时价值——这将允许你在更好的工具、流程,甚至是专用的文档资源上投入更多。”

整理你的清单。

从组织基础开始,而不是试图过快地变得太复杂。”只要把你列出的所有重要文件都放在电子表格中,努涅斯说。这里的目标是将所有内容集中到一个地方,而不是让人们执行“随机的文档行为”,从而导致混乱。

“这给了你一些湿粘土来想出一些结构,并最终将这些文档迁移到内容存储库中。但就目前而言,你可以在电子表格中快速识别出哪些文档是多余的,如果有任何显著的差距,以及更好的结构的机会。这风险很低,因为你只是处理一些url,你可以从人们那里得到反馈,但这比无数人把文档放在他们想要的地方要好得多,”努涅斯说。

当你在寻找要添加到你的电子表格中的文档时,请记住这5个存在于大多数大型公司中的文档桶。(努涅斯指出,规模较小的初创公司可能还不具备所有这些技术。)

新员工培训文档。这些类型的文件经常被忽视,但它们与其他类型的内容一样重要,甚至更重要。入职文件为新员工创造了一条有效的途径。”Nunez说。他建议采用一种简单、非结构化的入门方法:“随着团队的发展,要求每位新员工写下他们在最初几个月后学到的东西。每次招聘都将建立在之前记录的基础上。在短短几次招聘之后,这真的是一个可靠的入职指南,”他说。

人们很容易这样想:“我挺过了前六周,学会了为自己找到所有答案的艰难方法。”下一个人也能弄清楚。”但这肯定会拖慢新员工的脚步,限制他们的影响力。

基于任务的文档:例如,针对内部用户的关于如何构建新端点、与接口集成或使用新特性的说明。

运行手册:如何以特定顺序执行一组任务,以执行常见的操作任务,如启动新服务器或解决常见错误。

架构和设计文件:这是骨干文档,为所有其他文档和知识捕获提供有用的上下文,描述系统如何工作。

维基风格的团队文件:包括会议记录,备忘录,思考,建议。Nunez的建议是:“随意地写这些文档,但要与上面列出的其他文档分开。这些都是团队快速获取和分享知识的重要资源,但它们可能会非常嘈杂。”

如果在整个工程组织中找到各种文档并添加到你的电子表格中似乎是不可能的,他将其归结为简单的行军命令。“任何策展和组织都比没有好。如果你不想整理数百份文件,要快速取胜,只需查找最受欢迎的50个文档。这可以在一天内完成并产生立竿见影的效果努涅斯说。(大多数内容工具都有某种开箱即用的分析功能——或者如果你将文档存储在数据库中,你可以运行查询来获得这个列表。)

我发现大约10%的文档获得了大约90%的页面浏览量。如果你的资源紧张,只关注前10%,忽略长尾,直到你把自己的房子收拾好。

确定所有权。

你可以花几个小时来整理一份完整、清晰的文件。但是,人们经常会忽略一个最重要的组成部分:作者姓名。努涅斯说:“你可以用一个账本来记录哪个团队拥有哪个文档,但即使你在文档顶部手动输入一个团队名称,你也会创建更多的问责制,而且如果文档需要更新,人们也可以追踪到该团队。”

对于那些想要升级的人,他建议在页面的元数据中分配一个团队,这样就可以自动通知所有者按照预定的节奏或当代码更改时检查他们的文档。“随着公司的发展,每隔几个月就会重组一次。团队的名字会改变,或者人员会轮换。这就是你想要建造一些更复杂的东西的时候,”努涅斯说。

指派一个轮岗医生。

为了保持文档的集中化和可访问性,不仅要确定每个文档的中心所有者,还要确定中央电子表格的中心所有者,这是必不可少的——即使你还没有准备好聘请一个专门的文档。”如果您有10个团队负责自己的内容组织,那么没有人会关注这10个文档集如何形成一个内聚的整体努涅斯说。

他举了一个例子来解释为什么这会让人头疼:“在基础设施项目中,工程师经常希望执行端到端任务,他们可能需要使用多个团队构建的接口。如果文档被团队分割,那么完成这种端到端任务将是非常痛苦的。”

但是,如果没有特定的工程师或产品负责人提出要拥有文档的电子表格,可以尝试一种共同的方法,让一个轮流的所有者负责监控和维护电子表格一周,然后再把这个角色交给下一个人。“你是基本的主持人,你正在寻找异常值,‘哦,有人为这个主题创建了一个新文档,但我知道另一个文档已经存在了。’或者,‘有人把这个设为主页的子页面,但它实际上应该嵌套在另一个页面下面,就在这里,’”努涅斯说。

不要害怕删除。

他对保持文件条理的最大建议是什么?授权人们删除。“无论是意识到一份文件解释了一个不再存在的系统,还是一份完全过时的文件,人们害怕只是删除一个文档,即使它混淆了你的工程师和混乱的搜索结果.至少,你应该把它存档。通过移除不再有用的东西,你可以让整个系统变得更好。”

由于创建文档花费了大量的时间和精力,所以文档经常会拖延。但如果它完全过时了,那就弊大于利了。把它想象成一个花园,你必须修剪和轮作土壤以保持健康。

登陆页面升级。

在经历了电子表格组织练习之后,Nunez非常支持将登陆页面作为升级的一种方式。“登陆页经常被忽视,但很容易制作,而且非常有价值。这些是每个主要用户决策点的路标。”“大多数内部中心只是一堆文件,你尽最大努力搜索你需要的东西。但是你的内部搜索引擎和内部内容的SEO很可能很差。通过让内容更容易浏览来克服这一缺点。”

为了让事情变得简单,试着用下面这些登录页构建一个内部文档主页:

后端开发

前端开发

安全

度量和监控

存储和管理数据

第四步:将文档带入开发周期——不要等待代码完成。

到目前为止,我们已经讨论了通过编写丢失的文档并以易于追踪的方式组织它们来解决文档债务问题。但是真正找到文档天堂需要从被动的文档习惯转变为主动的文档习惯。这意味着记录开发一个新功能,而不是把它保存到发布后的最后。

但当面临时间紧迫的最后期限时,大多数团队倾向于将文档的编写推迟到特性发布之后。或者在努涅斯的案例中,有一次,他得知自己的团队在一次全体会议上与其他所有人一起被困在了关键文件的问题上。“有一次,我们的工程领导决定立即将我们内部认可的编程语言从7种减少到2种。对工程师的承诺是,用这两种语言编写的服务将被完美地记录下来。不出所料,在如此短的时间内,这一承诺在发布时未能兑现。

虽然很诱人,但将文档留到最后是交付劣质内容的最可靠方法,这会挫败开发人员,并最终挫败产品的用户。“总有一些新的东西可以做,而不是花时间记录你刚刚创建的东西。你要么在改进功能,要么在修复bug,要么只是代码完整,你不想再去想它了——你正在做下一件事,”Nunez说。

说你要在发布一项新功能后进行记录,就像说你要在新的一年开始节食一样——它永远不会按照你计划的方式进行。

快照。

Nunez称之为快照文档,这是一种简单的文档记录方式,而不是在代码完成后盯着空白页看。“创建快照仅仅意味着写下作为用户完成任务所需的实际步骤。在早期阶段,这可能会很混乱,但它应该是准确的。你还不需要概念上的上下文,只需要用户在使用产品完成你想让他们完成的任务时必须遵循的步骤和输入。”

这将为您的团队节省大量的时间和挫折——并最终产生更好的产品。“这不仅能让你对你的文档采取更可持续和迭代的方法,而且你还能获得有价值的见解,了解如何在产品生命周期的每个阶段取得成功。产品看起来可能很简单,但当你记录成功的步骤时,你可能会发现完成一项任务有25个独立的步骤,而你想把它减少到5个。”

迭代的文档草稿作为摩擦日志非常有用,因为它们可以预览用户将不得不处理的复杂性。

总结:开始吧。

就像没有一种行之有效的方法来找到适合市场的产品,组建你的早期团队和其他初创公司的“第一”,也没有一种方法来建立你的文档流程。“在加入工程组织作为他们的第一个文档雇佣,我首先开始生产网络新内容,或管理,或实施更好的工具,我首先开始布道。对于更好的内部文档来说,没有什么‘正确’的切入点——这只是一个开始。”他说。

因此,当您开始偿还文档债务时,请保持MVP心态——一砖一瓦地奠定基础,而不是试图在一天内建成罗马。