架橋のイシュー
GitLabイシューの概要については、GitLabイシュードキュメントをお読みください。
コミットメッセージより
コミットメッセージでイシューに言及するたびに、開発ワークフローの2つのステージ、つまりイシューそのものと、そのイシューに関連する最初のコミットとの間に関係が生まれることになります。
イシューとコミットするコードが同じプロジェクトにある場合は、コミットメッセージに#xxx
を追加するだけです。xxx
はイシュー番号です。同じプロジェクトにない場合は、イシューに完全な URL を追加します (https://gitlab.com/<username>/<projectname>/issues/<xxx>
)。
git commit -m "this is my commit message. Ref #xxx"
あるいは
git commit -m "this is my commit message. Related to https://gitlab.com/<username>/<projectname>/issues/<xxx>"
もちろん、gitlab.com
を自分の GitLab インスタンスの URL に置き換えることもできます。
関連イシューより
関連するイシューをマージリクエストやその他のイシューに記載することで、チームメンバーや共同作業者が、同じトピックに関する未解決のイシューがあることを知ることができます。
コミットメッセージからイシューに言及する場合は、上で説明したようにします。
issue#222
でissue#111
に言及すると、issue#111
のトラッカーにも通知が表示されます。 つまり、両方のissueに表示させるために、一度だけリレーションシップに言及する必要があります。マージリクエストでissueに言及する場合も同様です。
マージリクエストから
マージリクエストコメントでのイシューの言及は、関連するイシューの場合とまったく同じように機能します。
マージリクエストの説明でイシューに言及すると、イシューとマージリクエストが単純にリンクされます。 さらに、マージリクエストがマージされると同時にイシューが自動的にクローズされるように設定することもできます。