オントロジーの提案をレビューする

オントロジーの提案は、バージョン管理システムのプルリクエストに相当します。提案は、別のブランチで行われた変更を main に統合する前に、レビューして承認するための仕組みです。

グローバルブランチでは、Global Branching の提案が作成されると、オントロジーの提案が自動的に作成されます。この提案には、レビュー、名前、main にマージされる変更の説明などのメタデータが含まれます。レガシーのオントロジーブランチでは、ブランチの作成時にオントロジーの提案が作成されます。

このページでは、リソースのステータスの確認、タスクのレビュー、ブランチで行われた変更の表示など、オントロジーの提案をレビューする方法を説明します。

提案タブ

サイドタブから提案ページに移動すると、オントロジーの提案をすべて表示できます。提案は次のタブに分類されています。

• 自分の提案： 自分が作成した提案です。
• 自分に割り当てられました： 自分がレビュアーとして割り当てられている提案です。
• レビュー中： 進行中または承認済みの提案です。
• マージされた提案： メインオントロジーにマージされた提案です。
• クローズ済みの提案： マージされずにクローズされた提案です。

提案の表示

個別の提案の詳細については、提案の概要、プレビューの状態、変更を確認、Changelog の各タブにアクセスします。

提案の概要ページ

グローバルブランチで個別の提案にアクセスするには、ブランチのタスクバーから任意のオントロジーリソースを選び、Ontology Proposal を表示を選択します。メインブランチにいる場合は、提案タブに移動して、表示する提案を選択します。オントロジーブランチにいる場合は、上部のナビゲーションバーから提案の詳細を開くを選択すると、提案に直接アクセスできます。

提案内には、詳細を確認するための提案の概要、プレビューの状態、変更を確認、Changelog の各タブがあります。

提案の概要ページには、提案の段階、変更、レビューが必要なタスク、選択されたレビュアーがまとめられています。

• このブランチの変更を表示する： 概要ページの下部に編集内容が表示されます。編集内容は、作成者別およびタスク別に分類され、タスクはオントロジーリソースに対応します。変更を表示したり、リソースに移動したり、ブランチから変更を削除したりできます。変更履歴には Changelog タブからもアクセスでき、変更が行われた正確な時刻も表示されます。
• レビュアーを表示して追加する： 提案をレビューする同僚を指定します。
• 対応が必要なタスクを表示する： このセクションには、レビュー段階で拒否されたすべてのタスクが表示されます。
• 共有オプションを使用して、提案のリンクをコピーします。

プレビューのステータス

プレビューの状態タブには、このブランチでどのオブジェクトタイプがインデックス化済み、処理中、またはインデックス化不可であるかが表示されます。オブジェクトタイプがインデックス化済みになると、プレビューの準備が整い、そのデータをこのブランチで表示およびテストできるようになります。

変更をレビューする

変更を確認タブには、提案内のすべてのタスクが表示されます。ここでは、次の操作を行えます。

• 追加のレビュアーを招待する
• プロジェクトに移行済みのリソースの承認ポリシーを表示する
• タスクを個別に、または対象となるすべてのタスクを一括で承認または拒否する
• タスク単位でコメントを残し、同僚と共同作業する

変更履歴

Changelog タブには、ブランチの詳細な変更履歴が表示されます。タスクを展開すると、特定の時点で特定のユーザーが行った編集を確認できます。また、関連するオントロジーリソースに直接移動することもできます。

提案の権限

• 提案の閲覧： オントロジーへのアクセス権を持つ全ユーザーは、提案のタイトルと説明を発見できます。提案内の一部のリソースに対して少なくとも閲覧者のアクセス権を持つユーザーは、そのリソースに関連する変更を確認できます。
• オントロジーリソースの変更： リソースの編集権限を持つユーザーは、ブランチ上でそのリソースを編集できます。プロジェクト権限ではなくオントロジーロールを使用するリソースでは、閲覧者がブランチ上で変更を提案できます。
• 提案内のタスクの承認または拒否： タスクを承認するには、デフォルトでは承認者が対象リソースの編集者または所有者である必要があります。リソースがプロジェクトに移行済みで、保護されている場合は、代わりにプロジェクトのポリシーに基づく承認権限を承認者が持っている必要があります。
• オントロジーの提案のマージ： オントロジーの提案は、Global Branching の提案をマージすることでマージされます。ただし、レガシーのオントロジーブランチでは、必要な承認がすべて得られていれば、ブランチを閲覧できるユーザーなら誰でも提案をマージできます。