写五，然后合成：良好的工程战略很无聊。

我有点思考关于工程战略的写作很难，因为良好的策略是非常无聊的，而且写得很无聊。此外，我想当人们听到“战略”时，他们认为“创新” -Camille Fournier

少数公司了解他们的工程战略和愿景。这种不确定性的一个结果是行业信念，即这些文件难以写作。在一些谈话中，它可能觉得你在谈论一些神秘的东西，但这些只是平凡的文件。现实是，良好的工程战略很无聊，而且它是更轻松写一个有效的策略而不是坏人。

要编写工程策略，写五个设计文件，并将相似之处拉出来。这是你的工程战略。要编写工程愿景，写五个工程策略，并预测其两年内的影响到未来。这是你的工程愿景。

如果您无法抵制将最辉煌的想法包含到过程中的冲动，那么您可以将它们包含在您的备件中。将所有最好的想法写入巨大的文档，删除它，永远不会再提及任何一个。现在那些想法从你的脑子里出来，你的脑袋被清除了前进的工作。

久经图有用的工程战略和愿景是迭代，底层组织学习的产量。因此，所有学习都有助于您的组织的战略和愿景，但您的贡献不一定是如此摘要。即使您不直接负责该工作，您的贡献，也有实际的步骤您可以采取推进组织的战略和愿景，开始马上。

---

这是我早先写作的重新加工，工程战略。谢谢朱莉娅和卡米尔特别是他们有关改善它的建议。

写五个设计文档

设计文件描述了您在特定项目中所做的决定和权衡。您的公司可能会致电他们RFC或Tech Specs。陌生人名字也发生了;优步令人困惑地叫他们鸭子，直到他们以后在RFC上标准化。一个好的设计文档描述了一个特定的问题，调查可能的解决方案，并解释了所选方法的细节。有许多格式可以选择，几个地方开始思考是设计文档，标记和git和在谷歌设计文档。

如果给定的项目需要设计文件会归结为个人判断，但我发现了一些有用的规则。您应该为任何未来项目使用的任何项目编写设计文件。您还应该为有意义地影响您的用户的项目编写设计文档。您应该为任何需要花费超过一个月的工程时间的工作编写一个设计文档。

一批五种设计文档是编写有效策略的理想成分，因为设计文件具有错误的策略缺乏：详细的具体细节基于现实。同一团队中的两个良好意义的工程师很容易以不同方式解释抽象策略，但在实现特定解决方案时，它更难保持错位。

你写的一些建议：

• 从问题开始。解决问题陈述，解决方案越明显。如果解决方案不明显，请花更多时间澄清问题。如果你陷入了阐明这个问题，请展示你有五个人的东西，并问他们失踪了：新鲜的眼睛总是看到真相。
• 保持模板简单。大多数公司都有一个设计文件模板，这是一个很好的模式。但是，这些模板通常被扩展为服务太多的目标。过载模板劝阻人们首先写入设计文件。更喜欢最小的设计文档模板，允许作者选择最有用的部分，只能坚持最有限的详细信息，以获得最风险的项目。
• 聚集并审查，单独写。您非常不太可能在给定主题上写下最佳设计文档。在进入进程之前，从具有相关视角的人们收集来自人士的意见，特别是那些依赖您设计文件的输出的人。然而，持有将协作过程携带持怀疑态度，以写入设计文档本身。大多数人都是编辑的更好的作家。这意味着将组文档融入清晰的写作通常更难，而不是识别一个作者来编写更清晰的文档。聚集观点，但单独写。只是小心不要爱上你写的东西后你已经与他人审查过。
• 宁愿好好完美。最好写一份好文件并在别人面前得到它，而不是延迟更好的东西。在给其他人的设计提供反馈时，这尤其有价值，这很容易陷入预计其设计的陷阱与您的最佳设计一样好。特别是随着你的越来越高级，推动每一个设计都有毒性，以满足自己最好的工作的酒吧。专注于推动设计良好，而不是根据相关质量栏固定自己最佳。

写出伟大的设计文件需要很多练习。如果你想改善你的话，我最好的建议就是重读你的设计后您已经完成了它们，并研究从您的计划偏离的地方偏离的地方 - 导致这些偏差？哦，当然只要留意更多。

将这五个设计文档综合到战略中

在您的组织写入五个设计文件后，坐下并将其全部读。寻找多种设计中提出的有争议的决定，特别是那些难以达成的人。最近的矿山的例子是争论Redis是否适合作为耐用存储或仅作为缓存。如果我们审查了关于使用REDIS的最新决定，而不是从零开始，而不是从零开始，而不是从refyis的决定反映出如何做出决策，并将它们作为策略写下来？

良好的策略指导权衡，并解释了该指导背后的理由。不良策略陈述了一个没有解释的政策，从而从他们所作的上下文中解耦它们。没有上下文，您的策略迅速变得难以理解 - 为什么他们决定这一点？ - 难以适应基础的上下文转移。在思考写自己的时候阅读一些有趣的策略负责任的创新框架，和在松弛时会发生大的技术变化。

如果你是A.良好的策略，策略不好转换 - 那本书已经完全转换了我如何考虑战略 - 那么你会注意到这一战略的定义是“诊断”和“指导政策”部分，推迟到设计文件的“连贯行动”。

我撰写策略文件的最佳建议是：

• 开始你的位置。致力于战略，通过我们工作的固有巨大的歧义，很容易瘫痪，但你刚刚进入并开始写作。等待缺少信息不起作用：每次丢失的文件都缺少了一个充分的理由。无论您写的东西都需要改变，如果您写一些特别糟糕的话，你会很快意识到需要改变它的需要。你现在的位置总是是最佳的开始。
• 写下细节。写入直到开始概括，然后停止写作。如果您不能具体，请等到您提供更多的设计文件。具体陈述创建对齐;通用语句创建了对齐的错觉。
• 自以为是。良好的策略是自以为期的。如果他们没有自以为导，那么他们就不会在决策中提供任何清晰度。但是，自以为是自己不够，你也需要......
• 展示你的工作。在数学课程成长时，您必须展示您的工作以获得充分信用。在这里，您也必须显示您的意见背后的理由。显示您的工作在文档的第一个版本中建立了信心，但更重要的是，通过展示您的工作，您可以将其他人修改和扩展为基础的上下文转移。

你写的一些最好的策略可能会在时间感到太明显打扰写作。“我们什么时候应该写设计文件？”是一种值得一致的策略。“我们使用哪些数据库使用它使用案例？”是一种值得一致的策略。“在OFF-MOAK期间应该页面应该是哪种服务？”也值得一书。当我们留下战略的想法作为永久的光彩时，我们可以开始写得更多，我们可以随便地写下它们。如果未结束未使用，您可以稍后延期弃用。

将五种策略推断为视力

当您收集更多战略时，它会越来越挑战各种战略互动的原因。也许你的战略之一是逃避较少的软件并更多地依赖云解决方案，但您的另一个策略是在尽可能随行卸载到数据库的复杂性。如果识别允许您卸载大量复杂性的数据库，则如何调和这些策略，但您的云供应商不提供？

需要五个最近的策略，推断他们的权衡将如何在未来两到三年内发挥作用。当您通过矛盾编辑并将线程一起编辑时，您已经编写了工程愿景。最终版本会给你什么坦塔赖利呼叫对未来的强大信念，这使得更容易了解现有的策略如何相互关联，并简化了写作时间考验的新策略。

对于有用的愿景，一些要关注的事情是：

• 写两到三年。公司，组织和技术都迅速变化，以至于思考过于潮流的未来。如果您在六个月内撰写愿景，它也不起作用 - 您在六个月的窗口中逼真地写入多少策略？尽量关注两到三年，你可以扩展那个地平线，如果你是一个相当成熟的公司。
• 在您的业务和您的用户中的地面。有效的愿景为您服务您的用户和您的业务。紧张的连接保持愿景与领导团队的核心价值观和业务对齐。糟糕的愿景将技术复杂化视为一个自我辩解的目的，Raison d'être - 这一观点从未分享过贵公司的领导力。
• 乐观而不是大胆。愿景应该雄心勃勃，但他们不应该是大胆的。它们应该是可能的，但可能是可能的最佳版本。如果每个项目按时完成，并且没有重大挫折，请写出您可以完成的内容。不要用无限资源写出您认为的内容。
• 保持混凝土和具体。Visions获得更具体的有用。通用陈述很容易同意，但不禁协调相互矛盾的策略。比你舒服更详细。愿景中的细节通常是说明性的，而不是宣言，味道的味道的味道，而不是提供具有约束力的承诺。
• 保持一到两页长。现实是，大多数人都没有阅读长期文件。如果您编写了五页或六页的时间，读卡器将在不完成它的情况下开始下降（或者将非常快速地浏览它而不与细节接触）。强制自己通过链接到想要完整细节的人的子集，通过链接到其他文件来编写紧凑的东西，并参考额外的上下文。

完成愿景后，第一步是通常采取的第一步是在整个工程组织中广泛分享。视觉 - 五个设计文件背后有很多工作，为每个策略，一个视觉的五个策略 - 它很难不完成后兴奋。如果对您的策略的响应几乎总是静音，那么很容易受到沮丧。

静音反应有一些原因。首先，您的愿景的核心观众是人们写作策略，这是一个相对较小的队列。其次，伟大的愿景通常是如此明显它比兴奋更胆。不要通过创造的初始兴奋来衡量视觉。而是通过从两年前阅读设计文件，然后从上周开始来衡量它;如果有明显的改进，那么你的愿景很好。

何时何地

现在你有一个创造有效策略和愿景的配方，一个良好的跟进问题是，“我何时何时何地创造它们？”战略是主动对准的工具，使得赋予迅速和信心快速和信心。策略允许每个人 - 不仅仅是赋权的少数 - 以否则可能会花费他们一周的讨论。策略也是砖头缩小了许多可能的期货足够下来的砖块，以至于可以写一个现实的愿景。

当你重新讨论同样的讨论三到四次时，是时候写另一种策略了。当未来太朦胧识别值得制作的投资时，是时候写另一位愿景了。如果这些声音都不像熟悉的问题 - 现在转到其他工作并稍后返回。