Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Pattern Draft] governance-based-project-setup #699

Merged
merged 22 commits into from
Jan 6, 2025

Conversation

MaineC
Copy link
Member

@MaineC MaineC commented Jun 26, 2024

As discussed in Slack previously this adds a new pattern to link our Governance Levels with information on what pre-requisits need to be fulfilled to reach the respective governance level.

The pattern looks at several factors:

  • Knowledge needed by contributors and host team.
  • General advise on project structure.
  • Maturity levels that need to be reached.
  • Relevant patterns.

As discussed in Slack previously this adds a new pattern to link our Governance Levels with information on what pre-requisits need to be fulfilled to reach the respective governance level.

The pattern looks at several factors:
* Knowledge needed by contributors and host team.
* General advise on project structure.
* Maturity levels that need to be reached.
* Relevant patterns.
@MaineC MaineC added 1-initial Donuts, Early pattern ideas, ... (Please see our contribution handbook for details) 📖 Type - Content Work Working on contents is the main focus of this issue / PR labels Jun 26, 2024
@michael-basil
Copy link
Contributor

This pattern resonates. So from an atomic and or reductionist view it makes sense to stand on it's own. It is useful on it's own and many groups would or could benefit.

I also see stretch opportunities (taking a step back to an integrated or holistic view) with patterns that I/we (from Dojo Center) have proposed and that are in draft.

Stretch conversations can look orthogonal so I don't mean to necessarily unpack any intersection opportunities here.

Given a future professional opportunity as an influencer, director or coach I would consider leveraging the patterns above together.

TL/DR Very supportive and appreciative

@MaineC
Copy link
Member Author

MaineC commented Jun 26, 2024

I fully agree that we need another pattern with a more holistic view to go along with this one.

Thanks for your feedback, glad you find it helpful.

Copy link
Member

@spier spier left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you @MaineC for pushing your experiences into the open, in this case in the form of patterns!

I am just leaving some initial comments, and will do a more wholistic review at a later point.

Will already commit mini fixes that are purely formatting etc

@@ -0,0 +1,87 @@
## Title

Governance Level Guided Project Setup
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Found that title hard to understand. Need to think about a suggestion for a better one.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I fully agree - and: naming is hard :)

Hmm. I think I need help brainstorming here.

Something that puts "capabilities" into the title?

What this pattern does is to pull several separate patterns together into a subsystem. I'm sure there is a term for that kind of text. Maybe @kjstol or @NewMexicoKid can provide some information for that?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe something like "governance level drives maturity needs"?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We can improve the title later. Maybe once we find further adopters of the pattern.

@MaineC
Copy link
Member Author

MaineC commented Jun 28, 2024

Thanks for the initial review @spier - really appreciate the input on this one.

@MaineC
Copy link
Member Author

MaineC commented Sep 16, 2024

@spier I believe I addressed your comments. Is there anything left to change before this can be merged?

@spier spier changed the title Create governance-based-project-setup.md [Pattern Draft] governance-based-project-setup Dec 29, 2024
Copy link
Member

@spier spier left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@MaineC I have finally had time to fully digest your pattern here.

Only now I have actually understood what the pattern is trying to do, I think :) I have added some explanations at the beginning of the Solution section, describing my understanding if your approach.

I did wonder shortly if the content of this pattern could be merged into the "Governance Levels" pattern itself. Not sure about the pros-cons of this yet.

However as this PR has been sitting idle here for so long already, I suggest to get this merged in our repo, and decide at a later point how we want to proceed with this.

Having this fully integrated into our repo will make it easier to get more eyeballs by other readers on it.

Thank you for documenting your practical InnerSource experiences, and sharing these with us! And sorry that this review took so long

@@ -0,0 +1,87 @@
## Title

Governance Level Guided Project Setup
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We can improve the title later. Maybe once we find further adopters of the pattern.


The relevant levels of the [maturity model](../2-structured/maturity-model.md) are at least:

PP-1, DP-1, DC-1, RS-1, ST-1, CF-1, LS-1, OF-2, CB-2, SP-2, PA-2, RW-1, MP-1, SM-1, CL-1, RO-1
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It feels impractical for the readers to take the short codes from here, and look them up in the maturity model.

Unfortunately I don't have a better idea yet either. Maybe our publishing tooling (gitbook) has a solution for this. We can look at this again once we aim to get this pattern published in our book.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm also quite unhappy that we can't sort of link out directly. I included the information here because I believe, it's still valuable to have that link to the maturity model steps.

@MaineC
Copy link
Member Author

MaineC commented Jan 6, 2025

@MaineC I have finally had time to fully digest your pattern here.

Thanks so much for taking that time! (And: Happy New Year!)

Only now I have actually understood what the pattern is trying to do, I think :)
I have added some explanations at the beginning of the Solution section,
describing my understanding if your approach.

What you added sounds correct!

I did wonder shortly if the content of this pattern could be merged into the
"Governance Levels" pattern itself. Not sure about the pros-cons of this yet.

The reason I didn't do that is the length of the patterns: I wanted to keep Governance Levels very brief and concise so it's easy to read and understand. Also I wanted to keep focus there on the business decision itself without clouding the discussion with implementation details.

However as this PR has been sitting idle here for so long already, I suggest
to get this merged in our repo, and decide at a later point how we want to proceed with this.
Having this fully integrated into our repo will make it easier to get more eyeballs by other readers on it.

Sounds reasonable to me. :)

Thank you for documenting your practical InnerSource experiences, and
sharing these with us! And sorry that this review took so long

No worries - glad to see this pattern making progress.

Copy link
Member

@spier spier left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am leaving two comments open, that we may use as input when trying further improve this pattern in the future.

@spier spier merged commit c1ac2eb into main Jan 6, 2025
9 checks passed
@spier spier deleted the governance-based-project-setup branch January 6, 2025 19:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
1-initial Donuts, Early pattern ideas, ... (Please see our contribution handbook for details) 📖 Type - Content Work Working on contents is the main focus of this issue / PR
Projects
Status: Done
Development

Successfully merging this pull request may close these issues.

3 participants