开发者门户是提升开发者效率的重要利器，可以通过扩展对关键知识的获取并促进整个工程组织的领导工作，从而充分发挥作用。在本文中，我们将探讨如何以最有效的方式部署开发者门户，重点关注在开发者门户工具本身的基本功能之外，开发者门户能够实现的重要文化和实践变革，以及实现这些变革所需开展的组织变革。
在Thoughtworks，我们将工程效能定义为一种策略，工程组织可以借助这种策略提高生产力，以更少的投资快速提供更多的客户价值。我们对工程效能的看法包括但远不限于工程“卓越”、开发者体验和开发者满意度。
虽然该行业的大部分企业均专注于特定的热门话题（例如工程平台工具和可观察性），但我们的工程效能整体框架探索了产品和工程价值流中的六大重点领域，以及进行大规模变革所需的三项必要组织推动因素。其中一个热门话题即Backstage等开发者门户，已经纳入我们的“扩展知识和领导力”重点领域，它可以通过使人们能够快速查找信息并消除重复工作来减少资源浪费。
虽然开发者门户在提升工程团队效率方面发挥着重要作用，但如果您并未正确实施该门户，您将错失重大机会。在以下要点中，我们将概述开发者门户可以解决的问题，它无法做到或不应该尝试去做的事情，以及在实施过程中的成功模式和错误做法。因此，无论您是曾考虑过使用开发者门户但不知道从哪里开始着手，还是已经尝试实施了一个开发者门户但没有获得本可获得的回报，在开始（或重新开始）实现之前，您都需要了解以下内容。
1.开发者门户可充分满足以下四大主要工程需求：
1.1.集成搜索，在许多提供对单个位置数据的访问的不同系统中查找信息。
1.2.信息编目和检索所需有趣信息的能力。
1.3.文档即代码，尽可能接近开发代码，以便管理整个研发管道中的各项事务。
1.4. Scaffolding引擎或编排工具：为业务提供所需资源的机制。
2.工程团队需要充分参与。平台团队拥有一套特定的专业知识，但他们并不总是能洞悉全局。工程团队需要成为平台的优质“客户”，充分参与并主动负责解决其所面临的效率挑战。一种常见的失败模式是，平台组织拥有门户，并成为决定应该如何完成各项工作的仲裁者，但却并未得到开发者的认可，且并未充分了解开发者的需求及其面临的挑战。必须让工程团队自身以及其成功所需的因素来推动开发者门户实现其愿景和优先事务。
3.产品思维是关键。开发者是最终用户。您需要了解他们的痛点并加以解决。能力成熟度模型是一种系统化的方法，可以帮助您发现着手点。我们的目标是扩展知识、领导力和效率，并且可能还有更具价值的问题需要首先解决，而这些问题并不特别需要开发者门户来解决。如果没有解决更大的效率挑战，开发者门户就可能无法成功。
4.采取依靠基层的实现办法。找出造成问题的原因。哪些问题让您的开发者感到沮丧？解决什么问题将有助于提高他们的效率和满意度？我们发现的有效策略：
4.1.针对开发者的痛点做一些用户研究。
4.2.发起开发者满意度调查。
4.3.为开发者提供一个共享论坛，让他们畅所欲言地提出问题，然后为他们提供解决这些问题的空间。
5.将基层方法与自上而下的文化变革结合起来。领导层需要创造一种赞扬和激励基层行为的环境。如果没有适当的结构支持，自下而上的方法将会失败。
6.将门户构建为开发者可以寻找问题答案的平台，以建立其对门户的信心。减少开发者寻找和获取信息可能需要经过的渠道，避免大量冗余工作。通过逐渐增加新功能来提供价值，吸引他们重新回到门户。使用门户简化或自动执行目前让开发者感到沮丧的重复性工作。
7.通过贡献机制建立门户的共享所有权。开发者门户可以帮助打造一个允许每个人充分利用他人专业知识的环境。一旦人们开始做出贡献，他们就会融入其中，并将投入更多精力使其取得更大成功。避免由“高高在上”的核心团队来决定推荐的做法。
8.借助入门工具包促进新应用程序开发并建立最佳实践。虽然入门工具包可能无法解决所有传统技术问题，但它肯定能促进团队一致使用最佳实践来启动应用程序开发，如果重复几十次或数百次，就会形成真正的动力和变革。入门工具包是门户可以充分利用甚至可以自动使用的强大工具。
9.内部采购模式有助于消除重复，推动创新。通过提供共享和编目途径，使开发者能够在整个组织进行充分交流。平台工程组织应该是引入信息和实现内部采购模式的推动者。利用Backstage等门户采用内部采购模式。
10.可见性是开发者门户的神奇之处。最好的开发者门户实现非常实用，并且能反映组织的实际情况。门户可以提供有关正在使用的内容及其使用方式的数据。这将促进开展通常令人惊讶的重要新对话以及加深对组织工作状况的理解，揭示各种依赖关系或对遗留挑战的创造性务实解决方案，而在以前只有少数工程师或架构师能够意识到这些问题。当您暴露现实时，开发者通常会迅速而自愿地以之前可能从未优先考虑过的实用解决方案做出响应。这就是门户的神奇之处，您常常无法预测或“管理”您的方式。这通常会降低变革管理的障碍，有效实现新的工程行为。
如果得到有效实施，开发者门户将成为在整个组织中扩展知识和领导力的基本工具，并对提升开发者的生产力、满意度和人才保留率产生积极影响。