Skip to content

docs: clarify proposal-first contribution flow and update PR/issue templates#3395

Merged
quaquel merged 1 commit intomesa:mainfrom
wang-boyu:docs/contrib-workflow
Mar 1, 2026
Merged

docs: clarify proposal-first contribution flow and update PR/issue templates#3395
quaquel merged 1 commit intomesa:mainfrom
wang-boyu:docs/contrib-workflow

Conversation

@wang-boyu
Copy link
Copy Markdown
Member

As discussed among maintainers, feature PRs without prior alignment can create avoidable review burden. This PR is a first attempt to clarify our contribution flow so enhancements/new features follow a proposal-first process:

  1. Open an issue or discussion.
  2. Align on direction with maintainers.
  3. Open a PR only after maintainer approval.

Bug-fix PRs remain flexible: direct PRs are still generally fine for clear, scoped bugs.

To reflect this, this PR updates CONTRIBUTING.md and the PR/issue templates, including checkboxes to confirm either:

  • the PR is a bug fix, or
  • the PR is a feature/enhancement with prior approval.

Further comments and suggestions are very welcome!

@wang-boyu wang-boyu added the docs Release notes label label Feb 27, 2026
Copy link
Copy Markdown
Member

@quaquel quaquel left a comment

Choose a reason for hiding this comment

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

Looks good to me. I'll wait for some other maintainers to chime in as well before merging.

Copy link
Copy Markdown
Member

@tpike3 tpike3 left a comment

Choose a reason for hiding this comment

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

LGTM! Thanks @wang-boyu

@jackiekazil
Copy link
Copy Markdown
Member

LGTM

@EwoutH
Copy link
Copy Markdown
Member

EwoutH commented Mar 1, 2026

I think there are some good ideas in here. If it will working in practice, let's find that out.

@quaquel quaquel merged commit 0f3b626 into mesa:main Mar 1, 2026
4 of 5 checks passed
@wang-boyu wang-boyu deleted the docs/contrib-workflow branch March 1, 2026 20:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Release notes label

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants