From a6f601c7bb0a35728b998355d331c9a5cf888595 Mon Sep 17 00:00:00 2001
From: tarepan <tarepan5884@gmail.com>
Date: Mon, 6 May 2024 16:23:41 +0900
Subject: [PATCH] =?UTF-8?q?=E8=BF=BD=E5=8A=A0:=20issue=20=E7=8A=B6?=
 =?UTF-8?q?=E6=85=8B=E9=81=B7=E7=A7=BB=E5=9B=B3=E3=82=92=E4=BD=9C=E6=88=90?=
 =?UTF-8?q?=20(#1167)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* add: issue 状態遷移図を作成

* fix: pending をロードマップに変更

* fix: 語彙変更
---
 CONTRIBUTING.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index e5836b6a2..98b276d79 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -265,6 +265,30 @@ PYTHONPATH=. python build_util/make_docs.py
 
 不具合の報告、機能要望、改善提案、質問は<a href="https://github.com/VOICEVOX/voicevox_engine/issues/new">Issue</a>の方に報告してください。
 
+### Issue の状態
+VOICEVOX ENGINE では issue の状態遷移を以下のように整理しています。  
+各状態は GitHub の `状態：〇〇` ラベルと対応しています（例： [`状態：実装者募集`](https://github.com/VOICEVOX/voicevox_engine/labels/%E7%8A%B6%E6%85%8B%EF%BC%9A%E5%AE%9F%E8%A3%85%E8%80%85%E5%8B%9F%E9%9B%86)）。  
+
+```mermaid
+---
+title: issue 状態遷移図 v1.0
+---
+stateDiagram-v2
+    [*]     --> 必要性議論 : issue open
+    state opened {
+      必要性議論 --> 設計
+      設計       --> 実装者募集
+      実装者募集 --> 実装 : 着手宣言
+    }
+    opened      --> not_planned  : NoGo 判断
+    not_planned --> [*]          : issue close
+    実装        --> resolved     : Pull request merge
+    resolved    --> [*]          : issue close
+    opened      --> ロードマップ : 停滞
+    ロードマップ --> opened
+```
+NOTE: ロードマップ化すべきかの棚卸し判定は、issue が `必要性議論` で 30 日、`設計`・`実装者募集`・`実装` で 180 日停滞した場合におこなう。`実装` の停滞時にはサポートも検討する。
+
 ## ライセンス
 
 LGPL v3 と、ソースコードの公開が不要な別ライセンスのデュアルライセンスです。