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

Propose "why" folder that we will keep as "advisors" knowledge base #16

Merged
merged 1 commit into from Feb 27, 2024

Conversation

potiuk
Copy link
Member

@potiuk potiuk commented Feb 23, 2024

I would like to propose the "why" folder, where we will keep a (very) short summary about some of the rules and policies that we will be - as Advisors - discussing with the projects we will advise.

I think we need something like that - also as a place where we

  • advisors - will be able to update and exchange our understanding on why there are certain rules and policies. Also to discuss future variations and changes to those rules, possibly resulting from interactions with multiple PMCs when we will learn from them how they are applying certain rules and policies in their environment.

I gave an example of how I see such "why" captured information could look like - starting with the most familiar (for me) release process and I am curious what others think about it.

Copy link
Contributor

@rbowen rbowen left a comment

Choose a reason for hiding this comment

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

Interesting idea. Yeah, I like this. It also gives us something to point to when projects push back, in a "this isn't personal, it's just the way things are" kind of way. Especially in conjunction with the notion that we're also there to learn, and possibly improve the process/rules.

@potiuk
Copy link
Member Author

potiuk commented Feb 23, 2024

Interesting idea. Yeah, I like this. It also gives us something to point to when projects push back, in a "this isn't personal, it's just the way things are" kind of way. Especially in conjunction with the notion that we're also there to learn, and possibly improve the process/rules.

100% agree. There is a huge value in something being publicly stated in "semi-official" way. Just writing things down and pointing to it as a link is enough to stop treating things as personal opinion but something that is "commonly understood". Also when we connect it with the gorup of advisors who are mostly a "group ASF members who actually care enough to spend their personal time on helping other projects" has additional benefit that it is not seen as something that is "top-> bottom" but more like "group of peers agreed this is how it is".

wg-advisors/red-flags.md Outdated Show resolved Hide resolved
I would like to propose the "why" folder, where we will keep a
(very) short summary about some of the rules and policies that
we will be - as Advisors - discussing with the projects we will
advise.

I think we need something like that - also as a place where we
- advisors - will be able to update and exchange our understanding
on why there are certain rules and policies. Also to discuss future
variations and changes to those rules, possibly resulting from
interactions with multiple PMCs when we will learn from them how
they are applying certain rules and policies in their environment.

I gave an example of how I see such "why" captured information could
look like - starting with the most familiar (for me) release process
and I am curious what others think about it.
@potiuk
Copy link
Member Author

potiuk commented Feb 24, 2024

Ready for the next round of reviews.

@potiuk
Copy link
Member Author

potiuk commented Feb 27, 2024

If there are no more comments. I'd love to get this one merged and then maybe others (I can do as well) add a bit more why's for different areas. I think also - when we have a few whys we might actually regroup the "red-flags" and have them groupped according to the why they are referring to - rather than link them individually - but taht migh be a refactor of the docs when we add 2nd or 3rd why as well.

@rbowen rbowen merged commit 77f77e3 into apache:main Feb 27, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
4 participants