Linear
把 LaunchCal 的发布关联到它的 Linear 项目,发布就会跟随它:状态、进度和状态更新,每天同步,也可随时手动同步。
Linear 在 Taktoria 中的作用
在 LaunchCal 中,发布可以跟随构建它的 Linear 项目。项目的状态变化时,发布的状态随之变化;发布会显示项目的进度,项目的状态更新也会出现在发布上,这样负责人和评审人无需询问就能了解工作进展。
Taktoria 只从 Linear 读取:它绝不会在那里创建、更改或评论任何内容。Linear 是以应用而不是个人的身份连接的,因此无论是谁连接的,都能持续工作。
连接 Linear
只有工作区所有者或管理员才能连接 Linear。
- 打开设置 → 集成。
- 在工单系统下,选择连接 Linear。
- 在 Linear 中,选择要连接的 Linear 工作区,然后批准。
之后,卡片会显示连接的是哪个 Linear 工作区。每个 Taktoria 工作区连接一个。
把发布关联到项目
任何能编辑发布的人都可以关联、同步或取消关联它。
- 打开发布的详情标签页。
- 在工单项目下,把项目在 Linear 中的页面地址粘贴到项目链接。
- 选择关联项目。
项目必须位于已连接的 Linear 工作区中,关联后会立即同步。在 Linear 连接之前粘贴的链接会作为普通链接保留,连接后即开始同步。
连接到 LaunchCal 的 AI 助手和 REST API 也可以关联、同步和取消关联发布,规则相同。
同步什么,何时同步
已关联的发布在上线之前每天同步一次,有人选择立即同步时也会同步。
- 状态:项目的状态变化时,发布的状态随之变化:待办或已计划对应需求梳理,已开始对应开发中(已处于设计或测试的发布保持不变),已暂停或已取消对应已搁置。你在 LaunchCal 中选择的状态会一直保留,直到项目的状态再次变化。
- 进度:项目自身的进度。
- 状态更新:每条都会成为发布动态标签页上的一条进展,标有来自 Linear并附有指向原文的链接,发布的健康度跟随最新的一条。在 Linear 中修改后,下次同步会带来修改;发布会保留它们的历史。
- 完成:项目完成后,发布会显示已就绪,并通知其负责人。
同步带来的更改会在发布的历史记录、发给负责人的消息和审计日志中显示为来自 Linear。
它绝不会做的事
- 它绝不会发布任何东西。项目完成只会让发布就绪;必需评审全部决定后,仍然需要有人选择按下发布!。
- 它绝不会更改已经发布的发布。
- 它绝不会写入 Linear。
- 除非项目的状态再次变化,它绝不会撤销你在 LaunchCal 中选择的状态。
取消关联和断开连接
发布详情标签页上的取消关联会停止该发布的同步;已同步过来的内容会保留。
设置 → 集成中的断开连接会停止所有发布从 Linear 的同步,并撤销 Taktoria 在那里的访问权限。发布会保留已关联的内容以及到那时为止同步的所有内容,并在 Linear 重新连接后继续同步。
故障排除
- 找不到项目:它已被删除,或被移到了已连接工作区以外的 Linear 工作区。请关联它当前的地址。
- Linear 拒绝了连接:由工作区所有者或管理员在设置 → 集成中重新连接 Linear。
- Linear 没有响应上次同步:下次同步会再试,或稍后选择立即同步。
- 项目被保留为普通链接:Linear 尚未连接,或者该地址不是项目的地址。请粘贴项目本身页面的地址。
- 发布的状态没有变化:只有项目的状态变化时,同步才会改变它,而且发布上线后就再也不会改变。