-
Notifications
You must be signed in to change notification settings - Fork 262
Clarify required sections of the project proposal template #2810
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
base: main
Are you sure you want to change the base?
Clarify required sections of the project proposal template #2810
Conversation
@@ -22,7 +22,7 @@ In general, OTEPs are not accepted unless they come with working prototypes avai | |||
|
|||
Who is currently planning to work on the project? If a project requires specialized domain expertise, please list it here. If a project is missing a critical mass of people in order to begin work, please clarify. | |||
|
|||
### Industry outreach | |||
### Industry outreach (Optional) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Should we add these as markdown comments underneath the title?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Do you mean in addition to adding it to the title or instead of adding it to the title?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I still struggle with making this optional, I would rather like to see a structured process like:
- before start of the project, list who is aware already and who should be aware
- (optional) list whom you have reached out to so far/whom you plan to reach out to before the project starts
- (post approval, mandatory) work with SIG communications to make an announcement of the project via blog and social media
cc @open-telemetry/docs-approvers
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I still struggle with making this optional, I would rather like to see a structured process like:
I agree with you, but I would rather have this discussion in a separate PR. As it stands today, this is optional based on GC discussion. We can change that, but this PR tries to solve the previous problem: clarifying which parts are required and clarifying the relationship between the project management doc (which seems to be authoritative) and the template (which does not seem to be authoritative)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I agree with @svrnm's comments, I wouldn't make this optional, we should just clarify what's required
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I mean, the reality is that this is optional today, right? We can change it, but I just want to reflect the reality today
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I agree with @mx-psi.
I'd love to reignite the discussion about what we are expected to do as leaders of the project in ensuring that our community is not only accepting new contributors, but actively seeks to hear the voices of those who are known in the space where new projects are being proposed, which is what the current wording attempts to convey.
But the reality is that, today, we are not required to do this when proposing a new project. We assume people know about this new project because we believe we are big enough for people to follow closely what we are doing, and they'll naturally join. This PR marking this field as optional reflects this reality.
@@ -22,7 +22,7 @@ In general, OTEPs are not accepted unless they come with working prototypes avai | |||
|
|||
Who is currently planning to work on the project? If a project requires specialized domain expertise, please list it here. If a project is missing a critical mass of people in order to begin work, please clarify. | |||
|
|||
### Industry outreach | |||
### Industry outreach (Optional) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I agree with @mx-psi.
I'd love to reignite the discussion about what we are expected to do as leaders of the project in ensuring that our community is not only accepting new contributors, but actively seeks to hear the voices of those who are known in the space where new projects are being proposed, which is what the current wording attempts to convey.
But the reality is that, today, we are not required to do this when proposing a new project. We assume people know about this new project because we believe we are big enough for people to follow closely what we are doing, and they'll naturally join. This PR marking this field as optional reflects this reality.
Clarifies what sections from the project template are required, and which are to be filled after approval