Help pattern authors with Context + Forces

Offen

#419 erstellt am 26.5.2022 5 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit: 2/5
Geschätzter Aufwand: 1-3 Stunden
Anfängerfreundlichkeit: 35/100

Issue-Typ: Dokumentation
Klarheit: Größtenteils klar
Aktivitätsstatus: Veraltet
Bereich: content, documentation

Rechercherichtung

Suchen Sie die vom Issue referenzierte Pattern-Vorlage und prüfen Sie die vorhandenen Anleitungen zu Context und Forces. Vergleichen Sie die Vorlage mit den zitierten Review-Hinweisen und aktualisieren Sie diese Abschnitte mit klareren Anweisungen; abgeschlossen ist die Aufgabe, wenn Pattern-Autoren in der Vorlage umsetzbare Anleitungen vorfinden.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

:gear: Type - Meta

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