Skip to content

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

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

mx-psi
Copy link
Member

@mx-psi mx-psi commented Jun 11, 2025

Clarifies what sections from the project template are required, and which are to be filled after approval

@@ -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)
Copy link
Contributor

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?

Copy link
Member Author

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?

Copy link
Member

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

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 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)

Copy link
Member

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

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 mean, the reality is that this is optional today, right? We can change it, but I just want to reflect the reality today

Copy link
Member

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)
Copy link
Member

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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants