Skip to content

Commit e475294

Browse files
yuhattorspier
authored andcommitted
translated issue-tracker - jp
1 parent 6070e0a commit e475294

1 file changed

Lines changed: 22 additions & 19 deletions

File tree

Lines changed: 22 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,47 +1,47 @@
11
## Title
22

3-
Issue Tracker Use Cases
3+
イシュートラッカーのユースケース
44

55
## Patlet
66

7-
InnerSourceのホストチームは、計画や進捗だけでなく、変更の背景も透明化できていません。これは、プロジェクトの課題トラッカーのユースケースを増やし、ブレーンストーミング、実装の議論、機能設計にも使えるようにすることで解決されます。
7+
インナーソースのホストチームは、計画や進捗だけでなく、変更の背景も透明化することができていません。これは、プロジェクトのイシュートラッカーのユースケースを増やし、ブレーンストーミング、実装の議論、機能設計にも使えるようにすることで解決することができます。
88

99
## 問題
1010

11-
あるチームが、組織内の多くのチームが依存するコンポーネントを開発しています。このチームは、未解決のバグや機能要求を追跡するために、標準的な課題追跡システムを使用しています。しかし、各エントリのコンテキストは非常に限られています。その結果、潜在的なコントリビューターは、各課題がまさにどのような変更について話しているのかを知る術がありません。
11+
あるチームが、組織内の多くのチームが依存するコンポーネントを開発しています。このチームは、未解決のバグや機能要求を追跡するために、標準的なイシュートラッキングシステムを使用しています。しかし、各エントリのコンテキストは非常に限られています。その結果、潜在的なコントリビューターは、各課題がどのような変更について話しているのかを知る術がありません。
1212

1313
## 状況
1414

15-
InnerSourceのプロジェクトツールはすべてセットアップされています。しかし、プロジェクトの課題追跡システムは、主に進捗の共有のために使用されます。InnerSourceプロジェクトでは、リモートでの非同期通信を容易にするために、課題トラッカーが使用できるユースケースは他にもたくさんあります。
15+
インナーソースのプロジェクトツールはすべてセットアップされています。しかし、プロジェクトのイシュートラッキングシステムは、主に進捗の共有のために使用されます。インナーソースプロジェクトでは、リモートでの非同期通信を容易にするために、イシュートラッカーが使用できるユースケースは他にもたくさんあります。
1616

1717
## ブロッカーとなりうるちから (Forces)
1818

19-
* コントリビューターは、自分たちが必要としている機能がすでにロードマップにあるかどうかを理解したいと思っています。しかし、課題には多くの文脈が欠落しており、既存の課題が寄稿者のニーズに合致しているかどうかを判断することは不可能です。
20-
* その結果、多くの重複した課題がオープンされ、ホストチームがそれに対処しなければならなくなります。
21-
* オープンな課題のコンテキストは非常に限られているため、寄稿者はすでにオープンになっている簡単な課題を実装して、ホストチームを助けることができない。その結果、多くの作業がホストチームの手に委ねられることになります。
22-
* 口頭でのコミュニケーションに重点を置いているため、数ヶ月後や数年後に、なぜある機能が実装に選ばれたのかを見極めることができない。その結果、リファクタリング、特にコンポーネントの簡略化は、プロジェクト考古学のエクササイズとなり、議論されたことを覚えている人たちの脳を摘み取ることになる。
19+
* コントリビューターは、自分たちが必要としている機能がすでにロードマップにあるかどうかを理解したいと思っています。しかし、イシューには多くの文脈が欠落しており、既存のイシューがコントリビューターのニーズに合致しているかどうかを判断することは不可能です。
20+
* その結果、多くの重複したイシューがオープンされ、ホストチームがそれに対処しなければならなくなります。
21+
* オープンなイシューの文脈は非常に限られているため、コントリビューターはすでにオープンになっている簡単なイシューを実装して、ホストチームを助けることができません。その結果、多くの作業がホストチームの手に委ねられることになります。
22+
* 口頭でのコミュニケーションに重点を置いているため、数ヶ月後や数年後に、なぜとある機能が実装に選ばれたのかを見極めることができません。その結果、リファクタリング、特にコンポーネントの簡略化は、プロジェクト考古学そのものとなり、議論されたことを覚えている人たちの脳を巻き戻して考えるしかなくなります。
2323

2424
## ソリューション
2525

2626
純粋なソフトウェア開発だけでなく、新機能の企画段階でも「言葉より文字」の哲学を受け入れましょう。
2727

28-
* バグ、計画された機能、機能のアイデアについては、それぞれ別の課題を作成する。それぞれの課題には、外部の潜在的なコントリビューターが文脈を理解できるように、可能な限り多くの情報を含める。理想的には、特に簡単な変更については、外部のコントリビューターが問題の機能を実装することでホストチームをサポートできるよう、十分な情報を含めることです。
29-
* 質問するためのチャンネルとして、課題追跡システムを利用することもできます。これは、ユーザーの質問に取り組むための他のコミュニケーション源が不足している場合に、特に有用です。
30-
* 異なる目的で使用される課題を区別するために、タグやカテゴリーを使用します。
31-
* 非同期でブレーンストーミングを始めるには、アイデアを集めるために課題を開きます。議論が落ち着いてきたら、この課題で指摘されたことを別の文書にまとめます。それをプルリクエストとして投稿し、まだ説明が必要な個々のポイントについて掘り下げます。出来上がった文書は、他の適切なチャンネルで結果を公表したり、将来の参考資料として使用することができます。
32-
* ほとんどの課題追跡システムで、課題のテンプレートを作成することができます。バグレポートに必要な情報を集めるだけでなく、他の用途でどのような情報が必要なのかのヒントも含めて活用しましょう。
28+
* バグ、計画された機能、機能のアイデアについては、それぞれ別のイシューを作成します。それぞれのイシューには、外部の潜在的なコントリビューターが文脈を理解できるように、可能な限り多くの情報を含めるようにします。理想的には、特に簡単な変更については、外部のコントリビューターが問題の機能を実装することでホストチームをサポートできるよう、十分な情報を含めることです。
29+
* 質問するためのチャネルとして、イシュートラッキングシステムを利用することができます。これは、ユーザーの質問に対応するための他のコミュニケーション源が不足している場合に、特に有用です。
30+
* 異なる目的で使用されるイシューを区別するために、タグやカテゴリーを使用します。
31+
* 非同期でブレーンストーミングを始めるには、アイデアを集めるためにイシューを開きます。議論が落ち着いてきたら、このイシューで指摘されたことを別の文書にまとめます。それをプルリクエストとして投稿し、まだ説明が必要な個々のポイントについて掘り下げます。出来上がった文書は、他の適切なチャンネルで結果を公表したり、将来の参考資料として使用することができます。
32+
* ほとんどのイシュートラッキングシステムで、イシューのテンプレートを作成することができます。バグレポートに必要な情報を集めるだけでなく、他の用途でどのような情報が必要なのかのヒントも含めて活用しましょう。
3333

3434
## 結果の状況
3535

36-
* プロジェクトの課題追跡システム(イシュー・トラッカー)をコミュニケーションに活用することで、外部のコントリビューターがプロジェクトの動向を把握し、何をコントリビュートすべきかをより的確に判断することができるようになりました。
37-
* 文書によるコミュニケーションに重点を置くことで、ホストチームのメンバーが遠隔地から参加できるようになった。
38-
* 常に文書でコミュニケーションすることで、プロジェクトの決定事項に関する受動的な文書が副産物として蓄積され、特別な注意を必要としない。
39-
* 公開のコミュニケーションチャネルを常に使用することで、より多くの人間が議論に参加するようになる。これは、質問に答えたり、未解決の問題について発言したり、さもなければずっと後になって発見されるような計画された機能の欠陥を指摘できる、より知識のある人間がいることを意味します。
40-
* ディスカッションを公開の場に移すことで、将来コントリビューターになる可能性のある人々が、参加する必要が生じるずっと前に、潜んで、一緒にフォローし、快適に過ごし、プロジェクトのやり方を学ぶ機会を作ることができるのです。
36+
* プロジェクトのイシュートラッキングシステムをコミュニケーションに活用することで、外部のコントリビューターがプロジェクトの動向を把握し、何をコントリビュートすべきかをより的確に判断することができるようになります。
37+
* 文書によるコミュニケーションに重点を置くことで、ホストチームのメンバーがリモートで参加できるようになった。
38+
* 常に文書でコミュニケーションすることで、プロジェクトの決定事項に関する受動的な文書が副産物として蓄積され、特別な注意を必要としなくてすみます。
39+
* 公開コミュニケーションチャネルを一貫して使用することで、より多くの人間が議論に参加することになります。つまり、質問に答えたり、未解決の問題を指摘したり、計画中の機能の欠点を指摘したりできる、より多くの知識を持った人間を巻き込むことができるようになります。
40+
* ディスカッションを公開の場に移すことで、将来のコントリビューターとなる可能性のあるメンバーがが、プロジェクトに参加する必要が生じるずっと前に、プロジェクトに潜り込み、フォローし、慣れ親しみ、プロジェクトのやり方を学ぶ機会を作ることができます。
4141

4242
## 事例
4343

44-
* Europace AG - See blog post [Issue Use Cases](https://tech.europace.de/post/using-issues-for-asking-questions-and-tracking-work/)
44+
* Europace AG - ブログをご覧ください [Issue Use Cases](https://tech.europace.de/post/using-issues-for-asking-questions-and-tracking-work/)
4545

4646
## 著者
4747

@@ -50,3 +50,6 @@ Isabel Drost-Fromm
5050
## ステータス
5151

5252
Structured
53+
54+
## 翻訳の履歴
55+
- **2022-06-06** - 翻訳 [Yuki Hattori](https://github.com/yuhattor)

0 commit comments

Comments
 (0)