diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index bda8cfd9..ad892c93 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -48,6 +48,25 @@ git rebase main # <-- this will rebase `dagger/dagger` into your `FORK/dagger` git push -f -u fork mybranch # <-- update the pull request ``` +## Scope of Pull Requests + +We prefer small incremental changes that can be reviewed and merged quickly, +with no ceremony. It's OK if it takes multiple pull requests to close an issue. + +The idea is that each improvement should land in Dagger's main branch within a +few hours. The sooner we can get multiple people looking at and agreeing on a +specific change, the quicker we will have it out in a release. The quicker we +can get these small improvementes in a Dagger release, the quicker we can get +feedback from our users and find out what doesn't work, or what we have missed. + +The added benefit is that this will force everyone to think about handling +partially implemented features & non-breaking changes. Both are great +approached, and they work really well in the context of Dagger. + +"Small incremental changes FTW!" -> "Small pull requests that get merged within hours!" + +[Original context](https://github.com/dagger/dagger/pull/1348#issuecomment-1009628531) + ## Commits ### DCO