Using issues for brain­storming

Published On: 18. Dezember 2019|Categories: Tech|
using_brainstorming

Imagine the following situation: You’ve seen a certain discussion pop up multiple times and would like to draw the lessons learned together — but in a way that leaves space for others to provide their knowledge and experience.

One setup that turned out to be effective for this type of situation in gh#innersource was the following workflow:

  • Open an issue, post the problem statement at the very top and invite people to discuss steps towards a solution of the stated problem. Those steps can be based on prior lessons learned, general best practices or personal experience.
  • After the discussion has moved forward and people have a common under­standing one volunteer will summarize what has been discussed and accepted as valuable to share with others as a set of recom­men­da­tions.
  • The resulting document gets posted as a pull request. After that time is left for other parti­ci­pants to refine the document in pull request review comments and sugges­tions.
  • As soon as people affected by the decisions made in the document are in line the pull request is merged.
  • Going forward the decision can be refined again with subse­quent pull requests.

Caveat: Often those affected by the change will need to be notified expli­citly for as long as this approach is still new or in instances where company struc­tures shift.

This approach is a very simplified approach for making decisions in an asynchronous way. It’s in part inspired by how The Apache Software Foundation works, in part inspired by the Open Decision Making Framework, in parti­cular the exercise for making trans­parent decisions in the Open Organi­sation workbook.