Skip to content

Commit 1224912

Browse files
yuhattorspier
authored andcommitted
proofread common-requirements - jp
1 parent 71552b3 commit 1224912

1 file changed

Lines changed: 26 additions & 27 deletions

File tree

‎translation/japanese/patterns/common-requirements.md‎

Lines changed: 26 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1,64 +1,63 @@
11
## Title
22

3-
Common Requirements
3+
共通要件
44

55
## Patlet
66

77
共有リポジトリにある共通のコードは、それを使いたいすべてのプロジェクトチームのニーズを満たしていません。これは、要件の調整とリファクタリングによって解決されます。
88

99
## 問題
1010

11-
共有リポジトリにある共通コードは、それを使いたいすべてのプロジェクトのニーズを満たしていない。
11+
共有リポジトリにある共通コードは、それを使いたいすべてのプロジェクトのニーズを満たしていません。
1212

1313
## 状況
1414

15-
* 多くのプロジェクトが共通のコードを使おうとしている。 すべてのプロジェクトがアクセスする共有リポジトリがある。
16-
* 誰かが(またはどこかのプロジェクトが)最初にコードを書き、リポジトリに寄稿した。
17-
* 共通コードは、どのプロジェクトからの成果物全体から見ても、わずかな割合である。
18-
* 各プロジェクトには、それぞれ独自の納期、成果物、顧客がある。
15+
* すべてのプロジェクトがアクセスする共有リポジトリがあり、多くのプロジェクトが共通のコードを使おうとしています。
16+
* 誰かが(またはどこかのプロジェクトが)最初にコードを書き、リポジトリにコントリビュートしました。
17+
* 共通コードは、どのプロジェクトにおいても、成果物全体のうちのわずかな割合になります。
18+
* 各プロジェクトには、それぞれ独自の納期、成果物があり、別の顧客がいます。
1919
* このパターンは、これらの状況のいずれにも当てはまります。
20-
* **強力なコード所有者** すなわち、共有リポジトリへのすべての変更は、リポジトリの所有者によって承認されなければならない。
21-
* **弱いコードオーナー** すなわち、誰も本当にコードを所有していない。
22-
* **ベネヴォレント・スポンサー** が **いない**。 つまり、InnerSource方式で共通コードを整理するためのリソースを提供する組織や幹部がいない。
23-
24-
20+
* **強いコードへのオーナーシップ**: つまり、共有リポジトリへのすべての変更は、リポジトリの所有者によって承認されなければなりません。
21+
* **弱いコードオーナーシップ**: つまり、誰も本当にコードを所有していません。
22+
* **慈善のスポンサー**が**いない**: つまり、インナーソースの方法で共通コードを整理するためのリソースを提供する組織や幹部がいません。
2523

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

28-
コードを利用可能にしたプロジェクトには、1つのニーズがあります。そのニーズは、受け手の組織の一部が望んでいるものと似ていますが、まったく同じではありません。
29-
コードに関する要件は、実際の顧客のニーズから導き出される必要があります。
26+
コードを利用可能にしたプロジェクトには、ひとつのニーズがあります。そのニーズは、一部の受けての組織が望んでいるものと似ていますが、まったく同じではありません。コードに関する要件は、実際の顧客のニーズから導き出される必要があります。
27+
28+
異なる顧客のニーズが非常によく似ることはよくありますが、顧客によって表現が異なったり、重みが異なったりすることがあります。例えば、ある顧客はとある方法で結果を表示し、他の顧客は逆の順序で結果を表示することを望むような場合があります。両者の変換は簡単ですが、一方のケースで追加のコーディングが必要になり、その結果として、結果を計算するモジュールを両方の顧客で再利用することができなくなります。
3029

31-
異なる顧客のニーズは一般的に非常によく似ていますが、顧客によって表現が異なったり、重みが異なったりする場合があります。例えば、ある顧客はある方法で結果を表示してほしいが、他の顧客は逆の順序で表示してほしいというようなことです。両者の翻訳を行うのは簡単だが、一方のケースで追加のコーディングが必要となり、その結果、結果を計算するモジュールを両方の顧客で再利用することができない。
30+
多くの顧客は、サプライヤーに何が必要かを知るための手助けを望んでいる。この会社では、多くの「システムエンジニア」が製品の要求事項を書いている。これらの要件は、製品の開発を導くために顧客のニーズを抽出したものであると考えられている。コードの再利用は、会社の時間とお金を節約するための重要な目標である。
3231

33-
多くの顧客は、サプライヤーが必要なものを知るための手助けを望んでいる。この会社では、多くの「システムエンジニア」が製品の要求事項を書いている。 これらの要件は、製品の開発を導くために顧客のニーズを抽出したものであるはずだ。
34-
コードの再利用は、会社の時間とお金を節約するための重要な目標である。
32+
多くの顧客は、サプライヤーが必要なものを知るのを手伝ってくれることを望んでいます。同社には、製品の要件を作成するための多くのシステムエンジニアがおり、それらの要件は製品開発の指針となる顧客ニーズの抽出物であるとされています。コードの再利用は、会社の時間とお金を節約するための重要な目標です。
3533

3634
## ソリューション
3735

3836
この問題を解決するには、2つの側面があり、並行して行う必要があります。
3937

40-
1. あるプロジェクトの要件を満たすコードが、他のプロジェクトのニーズも満たすように、各プロジェクトの要件を揃える。
41-
2. コードをリファクタリングして、多くの使用プロジェクトが要件に合意できるような小さな断片にする。
38+
1. あるプロジェクトの要件を満たすコードが、他のプロジェクトのニーズも満たすように、プロジェクトの要件を調整する
39+
1. コードをリファクタリングして、多くの使用プロジェクトが要件に同意できるような小さな断片にする。
4240

43-
さらに、顧客がサプライヤに要求事項の解明を期待していることを利用する。顧客との交渉の中で要件のすり合わせを行い、コンポーネントを変更するのではなく、顧客の要件に影響を与える。
4441

45-
上記の例では、サプライヤーは、両方の顧客が同じものを求めていることを理解し、同じフォーマットで結果を受け入れることに同意すれば、全員の労力(および費用)を節約することができる。
42+
さらに、サプライヤーに要件の解明を助けてほしい顧客を活用します。 コンポーネントを変更するのではなく、顧客との交渉中に要件の調整を行い、顧客の要件に影響を与えます。
43+
上記の例では、サプライヤーは両方の顧客が同じことを望んでいることを認識できるように支援し、同じ形式で結果を受け入れることに同意すれば、すべての人の労力(およびお金)を節約できます。
4644

47-
![Common Requirements](../../assets/img/CommonReqtsv2.jpg)
45+
![Common Requirements](../../../assets/img/CommonReqtsv2.jpg)
4846

4947
## 結果の状況
5048

51-
そのためには、顧客と要件の変更について交渉する必要があるかもしれない。 また、営業チームやプロダクトマネージャーを巻き込んで、要件のすり合わせを行う必要があるかもしれない。 顧客は、変更に同意するために、割引などのインセンティブを必要とするかもしれない。
49+
これには、要件の変更について顧客と交渉する必要がある場合があります。そして、変更には要件を調整するために営業チームと製品マネージャーの関与が必要になる場合もあります。また、顧客は変更の同意の代わりに、割引などのインセンティブが必要になる場合があります。
5250

53-
関連する課題(および新しいパターンの可能性)として、InnerSourceを採用しているある企業で報告された循環型ストーリーライティングの演習がある。簡単に言えば
51+
これに関連する課題(新しいパターンの可能性)として、インナーソースを採用しているとある企業で報告されている「循環型ストーリーライティングの試行」があります。
52+
これは、端的に言うと以下のようなことです。
5453

55-
* 開発者は、ある方法で問題を解決するためにストーリーを書く。
56-
* プログラムマネージャーは、より良い彼らのニーズを表現するためにストーリーを書き換える - エッセンスは同じままである。しかし、開発者のもとに戻ってきたときには、それが自分たちのやりたかったことだと認識されておらず、そのため、実装に躊躇してしまう。
57-
* このパターンの解決策は、開発者やプログラムマネージャーの陣営だけでなく、プロジェクト全体でストーリーの修正が理解されるように、プランニングテーブルの周りに多くの席を設けることである。
54+
* 開発者は、ある方法で問題を解決するためにストーリーを書きます。
55+
* プログラムマネージャーはそのストーリーを自分たちのニーズをよりよく表現するために書き直します。しかし、開発者のもとに戻ってきたときには、開発者はそれが自分たちが最初にやりたかったことだと認識しておらず、そのため実装に躊躇してしまいます。
56+
* このパターンの解決策は、開発者やプログラムマネージャーの陣営だけでなく、プロジェクト全体でストーリーの修正が理解されるように、プランニングの際により多くの人を巻き込むことが挙げられます。
5857

5958
## 事例
6059

61-
* Large telecom provider
60+
* 大手通信事業者
6261

6362
## ステータス
6463

0 commit comments

Comments
 (0)