Skip to content

docs: added an ADR for small PRs #364

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.

Sign up for GitHub

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

Merged
wesrisenmay-mx merged 1 commit into from
Aug 14, 2026
+26 −0
Merged

docs: added an ADR for small PRs #364

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 26 additions & 0 deletions architectureDecisionRecords/0005SmallPullRequests.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
# Title

Small Pull Requests

## Date proposed

08-13-2026

## Context

Large pull requests have the following issues:

1. Exhausting and time consuming to review
1. Even more exhausting to re-review
1. Higher likelihood of important things being missed
1. Higher likelihood of suboptimal work being approved
1. Slow feedback cycle. You can follow a suboptimal path for longer before getting feedback. This results in more wasted work.
1. Big merge conflicts

## Decision

We will strive to create small, focused pull requests that fulfill a single purpose.

## Consequences

Code will get merged faster. Code will be of higher quality. Fewer bugs will be introduced. Less time will be wasted on suboptimal paths.
Loading