InnerSourceCommons / InnerSourceCommons/InnerSourcePatterns
Help pattern authors with Context + Forces
まだ誰も着手していません。
- 主要言語
- HTML
- スター
- 853
- フォーク
- 206
- 平均マージ
- 1日 23時間
- マージ済み PR(30日)
- 2
説明
Pattern authors often struggle with filling in the Context + Forces sections of our pattern template.
Could we give them more guidance on how to fill in Context + Forces?
@NewMexicoKid you are dropping nuggets of wisdom about these sections in your reviews sometimes (as in the example below). Could you help us extend the pattern template with further instructions, especially around these two sections?
Example of "nuggets of wisdom"
Whenever possible, forces should be stated in a way that indicates the trade-offs (which can hint at the levers by which one can react to a given force).
So if Product Owners are reluctant to be more collaborative and transparent, what is motivating them to do so? (Is it a cultural tendency to secrecy to protect proprietary information to gain a strategic advantage? If so, then is it a matter of noting which information needs to be protected vs. which info, when shared, can result in compensating advantages?)
Originally posted by @NewMexicoKid in https://github.com/InnerSourceCommons/InnerSourcePatterns/pull/417#discussion_r878929031
コントリビューションガイド
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
調査の方向性
issue が参照しているパターンテンプレートを見つけ、既存の Context と Forces のガイダンスを確認します。テンプレートを引用されたレビューの助言と比較し、それらのセクションをより明確な手順に更新します。テンプレート内でパターンの作成者が実行可能なガイダンスを得られる状態になれば完了です。
索引モデルが issue の本文から書いたものです。
評価
- 領域
- content, documentation
- issue の種類
- ドキュメント
- 難易度
- 2/5
- 見積もり時間
- 1〜3時間
- 活発さ
- 停滞
- 明瞭さ
- おおむね明確
- 初心者へのやさしさ
- 35/100