架橋のイシュー

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 に置き換えることもできます。

注意:最初のコミットをイシューにリンクすることは、GitLab Cycle Analyticsでプロセスをトラッキングするのに役立ちます。 GitLabCycle Analyticsでは、イシューの実装を計画するのにかかった時間、つまりイシューを作成してから最初のコミットを行うまでの時間を計測します。

関連するイシューをマージリクエストやその他のイシューに記載することで、チームメンバーや共同作業者が、同じトピックに関する未解決のイシューがあることを知ることができます。

コミットメッセージからイシューに言及する場合は、上で説明したようにします。

issue#222でissue#111 に言及すると、issue#111 のトラッカーにも通知が表示されます。 つまり、両方のissueに表示させるために、一度だけリレーションシップに言及する必要があります。マージリクエストでissueに言及する場合も同様です。

issue mentioned in issue

マージリクエストから

マージリクエストコメントでのイシューの言及は、関連するイシューの場合とまったく同じように機能します。

マージリクエストの説明でイシューに言及すると、イシューとマージリクエストが単純にリンクされます。 さらに、マージリクエストがマージされると同時にイシューが自動的にクローズされるように設定することもできます。

issue mentioned in MR