Skip to content

feat: ✨ bring in content on commits and PRs from elsewhere - #157

Open
joelostblom wants to merge 16 commits into
mainfrom
docs/pr-howto
Open

feat: ✨ bring in content on commits and PRs from elsewhere #157
joelostblom wants to merge 16 commits into
mainfrom
docs/pr-howto

Conversation

@joelostblom

Copy link
Copy Markdown
Contributor

Description

This PR brings together the content from the following sources (let me know if there was some other location with relevant we had in mind):

Closes #148, closes #147

Needs a thorough review.

Checklist

  • Ran just run-all

@joelostblom joelostblom changed the title feat: ✨ consolidate condiate on commits and PRs from elsewhere feat: ✨ bring in content on commits and PRs from elsewhere Aug 19, 2026
@joelostblom
joelostblom marked this pull request as ready for review August 19, 2026 11:22
@joelostblom
joelostblom requested a review from signekb August 19, 2026 11:22
@joelostblom joelostblom moved this from Todo to Done in Platform development Aug 19, 2026
@joelostblom joelostblom moved this from Done to In review in Platform development Aug 19, 2026

@signekb signekb left a comment

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.

Very, very nice work! 🌟

This did take quite a long time to review (quite a lot of line changes, resulting in 44 suggestions and comments), so I wonder if it would've been nicer as two separate PRs, one for commits and one for PRs 🤔

Comment thread workflows/commits.qmd Outdated
Comment thread workflows/commits.qmd Outdated
Comment thread workflows/commits.qmd Outdated
Comment thread workflows/commits.qmd Outdated
Comment thread workflows/commits.qmd Outdated
Comment thread workflows/prs.qmd Outdated
Comment thread workflows/prs.qmd Outdated
Comment thread workflows/prs.qmd Outdated
Comment thread workflows/prs.qmd Outdated
Comment thread workflows/prs.qmd Outdated
@github-project-automation github-project-automation Bot moved this from In review to In progress in Platform development Aug 19, 2026

@joelostblom joelostblom left a comment

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.

Thanks for the thorough review! I agree that we probably could have split this into two but there was also some content that moved between the files so in that change it was helpful to see it together.

Comment thread workflows/commits.qmd Outdated
Comment thread workflows/prs.qmd
Comment thread workflows/prs.qmd Outdated
Comment thread workflows/commits.qmd Outdated
Comment thread workflows/commits.qmd Outdated
Comment thread workflows/prs.qmd Outdated
Comment on lines +205 to +208
Avoid stacked PRs, where one open PR targets the branch of another open
PR, unless there is an exceptional reason to use them. Dependencies
between PRs make review and merging harder. We prefer independent changes;
otherwise, clearly identify the dependency and required merge order.

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.

We might reconsider this now that the stacked PR feature on github is evlolving, but I left it for now

Comment thread workflows/prs.qmd Outdated
Comment thread workflows/prs.qmd Outdated
Comment thread workflows/prs.qmd
Comment thread workflows/prs.qmd Outdated
@joelostblom
joelostblom requested a review from signekb August 20, 2026 11:52
@joelostblom joelostblom moved this from In progress to In review in Platform development Aug 20, 2026

@signekb signekb left a comment

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.

Nice work ☀️ A couple of very minor suggestions:

Comment thread workflows/prs.qmd Outdated
Comment thread workflows/prs.qmd Outdated
Comment thread workflows/prs.qmd Outdated
@github-project-automation github-project-automation Bot moved this from In review to In progress in Platform development Aug 25, 2026
joelostblom and others added 3 commits August 26, 2026 09:57
Co-authored-by: Signe Kirk Brødbæk <40836345+signekb@users.noreply.github.com>

@joelostblom joelostblom left a comment

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.

Thanks, updated! I know your away on vacation so I'll let this sit for a bit and then either ping someone else or self-merge since there were only minor edits since your last approval.

Comment thread workflows/prs.qmd Outdated
Comment thread workflows/prs.qmd Outdated
@joelostblom
joelostblom requested a review from signekb August 26, 2026 08:09
@joelostblom joelostblom moved this from In progress to In review in Platform development Aug 26, 2026

@lwjohnst86 lwjohnst86 left a comment

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.

Very nice! Some suggested changes 🎉

Comment thread workflows/commits.qmd

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.

Could you also delete the text from where you pulled it in those other repos?

@joelostblom joelostblom Sep 1, 2026

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.

Comment thread workflows/commits.qmd Outdated
Comment thread workflows/commits.qmd Outdated
Comment thread workflows/commits.qmd Outdated
Comment thread workflows/commits.qmd Outdated
The `<description>` section is a short summary of the change. Write it
in the imperative, present tense (i.e., "change" not "changed" nor
"changes") without a period at the end. Be specific enough that another
person can distinguish the commit from others without reading the diff.

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.

Suggested change
person can distinguish the commit from others without reading the diff.
person can distinguish the commit from others without reading the difference.

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.

Here, I would keep diff since it is referring to the specific term. I clarified by prefixing with "commit"

Suggested change
person can distinguish the commit from others without reading the diff.
person can distinguish the commit from others without reading the commit diff.

Comment thread workflows/prs.qmd Outdated
Comment thread workflows/prs.qmd Outdated
Comment thread workflows/prs.qmd Outdated
Comment thread workflows/prs.qmd Outdated
Comment thread workflows/prs.qmd
@github-project-automation github-project-automation Bot moved this from In review to In progress in Platform development Aug 28, 2026

@joelostblom joelostblom left a comment

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.

Thanks, updated and ready for another review!

joelostblom and others added 2 commits September 1, 2026 11:18
Co-authored-by: Luke W. Johnston <lwjohnst86@users.noreply.github.com>
Co-authored-by: Joel Ostblom <joelostblom@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: In progress

Development

Successfully merging this pull request may close these issues.

Move over content from git4cats on atomic PRs/commits Move over post from team/internal about atomic PRs/etc

3 participants