Skip to content

Conversation

Copy link

Copilot AI commented Jan 12, 2026

Recurring issues with draft PRs lacking clear descriptions or intent have caused confusion about when and how to comment. Contributors were using draft status as a shield from feedback rather than a tool for early collaboration.

Changes

Added "Using Draft Pull Requests" section to CONTRIBUTING.md clarifying:

  • What draft status means: Work in progress, seeking early feedback, requesting help, sharing progress
  • What it does NOT mean: Not a dump for unclear changes, not a shield from comments, not a substitute for local development
  • Requirements for drafts: Clear intent/description, understandable changes, specific questions if help needed, reasonable completeness for meaningful review
  • Conversion guidance: Reference to existing PR checklist when ready for final review

Positioning

Placed after "Creating a Pull Request" section for logical workflow progression. Links to existing "What does a valid PR look like?" checklist to clarify transition expectations from draft to ready-for-review.

Original prompt

We have an recurring problem with raft PRs and therefore like to clarify the contributing file.

Take this as examples:

These all where initally created as a draft with insufficent description or unclear state and people are confused and then argued that its a draft PR andone should probabbly not look at it.

For me a draft does not mean "leave me alone with your stupid comments" it is more something I like to share with the community, maybe getting some early feedback or help with some issues I'D like to solve.

A draft means it's not ready for submission (for whatever reason, e.g. not fully working, incomplete in tests), but of course others should be allowed to make comments and should be able to understand the intend and current state.It's not a dump for changes, one can use the local computer for that or simply just push changes to a fork's branch (and not create a PR from it).But every PR should be clear in it's intend.

Please help to clarify the contributing docs so we can use them as a reference fior further cases.


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Clarifies expectations for draft pull requests including:
- What draft status means (seeking feedback, work in progress)
- What it does NOT mean (not a shield from comments)
- Requirements even for drafts (clear intent, understandable changes)
- When to convert to regular PR

Co-authored-by: laeubi <1331477+laeubi@users.noreply.github.com>
Copilot AI changed the title [WIP] Clarify guidelines for using draft pull requests Add draft PR guidelines to CONTRIBUTING.md Jan 12, 2026
Copilot AI requested a review from laeubi January 12, 2026 10:41
@laeubi laeubi marked this pull request as ready for review January 12, 2026 10:49
@laeubi laeubi merged commit 18f4a5e into main Jan 12, 2026
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.

2 participants