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 尚未連結,或者該網址不是專案的網址。請貼上專案本身頁面的網址。
- 發布的狀態沒有變更:只有專案的狀態變更時,同步才會變更它,而且發布推出後就絕不會再變更。