工程团队的 Baklib 应用：从项目反馈到文档管理_

积极的项目反馈## 工程团队如何使用 Baklib

了解客户 RS21 和 Baklib 自己的工程团队如何使用 Baklib 来确保其开发文档（包括流程和模板）的未来发展。

环境设置和入门

最佳实践和团队标准

项目规划和开发文档

面向未来的文档

所有工程团队都依赖某种文档工具与同事沟通重要的产品信息。对于刚起步的小型团队，这可能就像 Google Doc 一样简单，而对于拥有复杂产品的大型团队，这可能是一个分层的 Wiki。根据公司的结构，其他团队（如人力资源或营销）也可能使用此 Wiki，或者有其他区域来存储团队信息。

我们认为将所有公司知识集中在一个中心位置是最有效的，我们也知道工程团队的需求是具体的、细致的和技术性的。让我们通过我们自己的团队和 Baklib 客户 RS21 的示例，了解 Baklib 支持工程团队文档需求的一些方式。

环境设置和入门

加入新的工程团队（无论是内部还是外部）时，入职流程对于确定新队友是否能快速做好贡献至关重要。从设置编码环境到阅读功能文档，需要做很多事情才能快速适应并做好新工作的准备。

对于许多工程团队来说，入职流程最终会给另一位队友带来麻烦，这位队友被指定为新员工的“伙伴”，并会实时指导他们了解这些信息。但通过为团队提供专家验证的、最新的 Baklib 卡片，RS21 的工程领导者让新员工能够灵活地按照自己的节奏进行入职。这让他们可以节省与入职“伙伴”相处的时间，以便建立更多的人际关系或解决未解决的问题。

当新工程师加入 RS21 团队时，他们会登录 Baklib 开始处理入职材料。他们将浏览“团队信息”板，了解一些队友的情况，使用基础设施卡正确设置环境，并阅读团队的编码标准，了解如何与新同事进行最佳合作。

同样，在 Baklib，当工程师加入或转入新团队时，他们的入职培训也在 Baklib 中完成。他们将使用人生故事卡来了解队友，查看有关如何合作的指南，并在 Baklib 中浏览新团队的合集，以熟悉他们现在负责的产品功能和领域。

重要的 Slack 频道

#我们的团队名称是我们的主要沟通方式。它用于我们团队的各种公告、信息共享和庆祝活动。

#ch-our-team-name 是我们在 Clubhouse 项目中发生的一系列活动。它的主要作用是可以快速了解正在发生的事情，而无需查看 Clubhouse 中的通知。

最佳实践和团队标准

一旦整个团队都加入进来，持续的资源（如编码标准和文档最佳实践）也会在 Baklib 中占有一席之地。当以工作流程中可访问的方式记录这些资源时，工程师可以更轻松地与团队其他成员和公司其他成员进行富有成效的协作。这还可以防止他们记住任何政策或程序，或者更糟的是，收藏和依赖过时的文档。

RS21 在 Baklib 中的工程集合包括一个专门用于流程指南的板块，其中包括带有合并代码、创建 bash 脚本、请求代码审查等说明的卡片。他们还有专门用于团队商定的编码语法样式、AWS 设置说明、系统管理员信息等的板块。他们甚至在 Baklib 卡片中提供了常用的代码片段，可轻松复制粘贴。

除了这些工程专用卡片之外，Baklib 也是工程师获取跨职能最佳实践和团队间流程指南的绝佳场所。例如，RS21 团队使用 Baklib 进行异步讨论，以便团队成员有更多时间深思熟虑地做出回应，并为每个人提供公平公正的平台来做出贡献。有关如何设置和监控这些讨论的说明保存在 Baklib 模板中，以便任何人都可以在需要时轻松启动一个。

异步产品头脑风暴

使用此远程友好模板来促进团队集思广益。了解有关此模板的更多信息。

什么是异步头脑风暴？

异步产品头脑风暴适合远程协作，团队成员可以在最适合他们的情况下通过虚拟方式参与。讨论在 Baklib Card 上进行，以响应鼓励创造力的提示。利益相关者对主要主题做出贡献，并在现有主题下添加评论作为子项目符号。

通过 Baklib 获得它有什么好处？

每个人都可以自由地做出贡献，而不仅仅是房间里最资深（或最外向）的人
多人可以同时写作
可以轻松添加代码、示例和参考链接、屏幕截图和嵌入内容来分享您的想法
Baklib 可直接与您喜爱的所有应用程序集成，从而防止信息过载 - 无需更换浏览器或登录另一个工具即可轻松快速地找到信息
Baklib 为团队提供单一事实来源，可免费与任何队友共享，以提高可见性

团队使用此模板进行怎样的头脑风暴？

产品创意
开发流程改进
团队文化
新功能

如何开启一场适合远程办公的头脑风暴：

要编辑此卡片，请获取上面的模板。更新头脑风暴主题的标题。
包括正在讨论内容的描述以及人们可能需要的任何有用的背景信息。
包括结束日期，以便人们知道何时应该添加贡献。
在头脑风暴过程中，将卡片保持“未验证”状态，以快速指示头脑风暴正在进行。
在贡献前放置表情符号来识别特定贡献者。
在卡片顶部包含贡献者和他们的表情符号的图例。
使用 +1 来同意另一位贡献者的观点，并确定参与者广泛认同的想法。
要为某个点添加 +1，只需在行尾输入 [your-emoji]。如果有人已经添加了 +1，您可以将自己的表情符号添加到他们的表情符号旁边。

在 Baklib，我们邀请产品开发组织以外的团队来协助我们的质量保证 (QA) 流程。有了更多不同的观点，我们就能更好地识别错误、探索潜在的客户挑战并在发布之前预防它们。但是，当涉及跨职能团队时，像 QA 这样技术性的流程需要记录说明和程序。在开始新功能的 QA 之前，工程团队负责人将使用我们的 QA 流程模板为我们的团队和利益相关者创建一站式服务，以提供端到端 QA 所需的一切。当我们准备开始 QA 时，他们会将此作为公告发送给团队和利益相关者，并在消息中包含有效的 QA 日期。

功能 QA 流程

使用此模板为您的团队提供在产品发布新功能之前测试新功能所需的一切。

此功能已正式准备好进行 QA。如果您参与了此功能的测试，请按照以下说明开始测试。

专业提示：将此卡作为 Baklib 中的公告发送给参与 QA 流程的小组。

每当一个新的开发项目启动时，都会有大量的文档记录，以确保每个人都有充分的背景信息，以便发挥自己的作用。启动会议后，工程师们需要依赖产品团队提供的需求文档、用户体验团队提供的最新功能设计、营销或文案团队提供的文案等等。

当然，他们经常需要参考影响他们正在开发的功能的技术文档，或者他们需要在以后的开发中更新的技术文档。

在 Baklib，我们会在由每个项目的工程主管支持的“活动项目资源卡”中跟踪产品开发所需的各种资源。这些资源卡是工程团队在产品开发生命周期的早期阶段的首选资源，并会保持更新以反映整个过程中的任何变化。

随着开发过程的进展，工程和设计之间的协作必须保持步调一致。但由于工作通常具有异步和远程性质，设计师和工程师无法总是通过 Zoom 电话讨论任何问题或反馈。为了确保他们遵循我们商定的内部协议来征求设计反馈，我们的工程团队使用了 Baklib 中记录的 UI 更改设计反馈工作流程。

积极的项目反馈

使用此模板记录您的工程团队在整个积极的产品开发过程中征求反馈的过程。

主动项目反馈说明

当进行影响 [产品名称] 的 UI 和 UX 的更改时，需要工程团队成员和 [设计、产品、产品营销等] 的同事提供反馈。创建拉取请求以供工程审查后，请完成以下步骤以收集必要的利益相关者的反馈：

创建屏幕截图或短视频，介绍审阅者应该注意的更改
复制分支应用链接，打开后即可立即构建拉取请求
将分支应用程序和任何资产（视频/截图）粘贴到 Slack 频道 [#teamname-ui-qa]
标记来自[设计、产品、产品营销等]的适当利益相关者，以提高可见性
利益相关者应该在 Slack 帖子上发表反馈，或者如果没有进一步的反馈，则用勾号 ✅ 来回应

面向未来的文档

文档一直是并且将永远是工程师工作中必不可少的一部分。但是，当文档直接纳入他们的工作流程时，曾经引起痛苦呻吟和苦恼叹息的事情可以成为他们日常生活中简单而自然的一部分。Baklib 的浏览器扩展将文档直接带到工程师需要的地方，而不是强迫他们切换上下文来访问它，而简短的、专家验证的卡片减轻了过去长篇文章的压力，这些文章写起来很麻烦，维护起来更困难。那么，既然您现在可以轻松地为未来做好准备，为什么还要用过时的文档来增加技术债务呢？今天免费开始。