Skip to content

docs: Add guidelines for handling serial PR dependencies#98391

Closed
JarmouniA wants to merge 1 commit into
zephyrproject-rtos:mainfrom
JarmouniA:doc_contributor_multiple_PRs
Closed

docs: Add guidelines for handling serial PR dependencies#98391
JarmouniA wants to merge 1 commit into
zephyrproject-rtos:mainfrom
JarmouniA:doc_contributor_multiple_PRs

Conversation

@JarmouniA
Copy link
Copy Markdown
Contributor

@JarmouniA JarmouniA commented Oct 28, 2025

Clarify the process for managing and reviewing pull requests with serial dependencies. This helps contributors understand how to structure, propagate changes, and validate dependent PRs effectively.

Originated from #90216 (comment)

Doc preview https://builds.zephyrproject.io/zephyr/pr/98391/docs/contribute/contributor_expectations.html#contributor-expectations

@JarmouniA JarmouniA marked this pull request as ready for review October 28, 2025 10:51
@JarmouniA JarmouniA force-pushed the doc_contributor_multiple_PRs branch from 61d4777 to 9041daa Compare October 28, 2025 11:00

- Propagate Changes

Any updates to PR A must be manually propagated to PR B, and then from PR B to PR C.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Mention that propagation must happen after the PR is merged.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Do you mean PR B is rebased on main after A is merged?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Yes, exactly.

Clarify the process for managing and reviewing pull requests with serial
dependencies. This helps contributors understand how to structure,
propagate changes, and validate dependent PRs effectively.

Signed-off-by: Abderrahmane JARMOUNI <git@jarmouni.me>
@JarmouniA JarmouniA force-pushed the doc_contributor_multiple_PRs branch from 9041daa to 68e157c Compare October 28, 2025 12:26
@sonarqubecloud
Copy link
Copy Markdown

@fabiobaltieri
Copy link
Copy Markdown
Member

Not sure how I feel about this to be totally honest, github makes it so hard I feel like the guideline should be "don't do it"

@github-actions
Copy link
Copy Markdown

This pull request has been marked as stale because it has been open (more than) 60 days with no activity. Remove the stale label or add a comment saying that you would like to have the label removed otherwise this pull request will automatically be closed in 14 days. Note, that you can always re-open a closed pull request at any time.

@github-actions github-actions Bot added the Stale label Feb 15, 2026
@kartben
Copy link
Copy Markdown
Member

kartben commented Feb 25, 2026

I am not sure this how things are done today. It feels odd to document that people should open draft PRs when in fact I believe they should be open-open (with a clear indication of which commit(s) may be reviewed) but simply marked as DNM.

@JarmouniA
Copy link
Copy Markdown
Contributor Author

when in fact I believe they should be open-open

The problem with that is when what's being contributed is touching many areas, it results in a ton of unrelated reviewers & labels being added to the subsequent PRs, so no one knows what PR to review really.

@JarmouniA JarmouniA removed the Stale label Feb 25, 2026
@github-actions
Copy link
Copy Markdown

This pull request has been marked as stale because it has been open (more than) 30 days with no activity. Remove the stale label or add a comment saying that you would like to have the label removed otherwise this pull request will automatically be closed in 7 days. Note, that you can always re-open a closed pull request at any time.

@github-actions github-actions Bot added the Stale label Mar 29, 2026
@github-actions github-actions Bot closed this Apr 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants