Update docs/contributing.md to document dependent chains
This commit adds a section to the Contributing docs, describing
how to make dependent changes in relation chains.
Change-Id: I175bca04c9d5af559c0ceb12f5611d6b0f5ee8e7
Bug: None
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/4278925
Reviewed-by: Hidehiko Abe <[email protected]>
Reviewed-by: Erik Chen <[email protected]>
Commit-Queue: Andrea Orru <[email protected]>
Cr-Commit-Position: refs/heads/main@{#1110158}
diff --git a/docs/contributing.md b/docs/contributing.md
index 7b37d48f6..f71c7c2a 100644
--- a/docs/contributing.md
+++ b/docs/contributing.md
@@ -202,6 +202,30 @@
See `git cl help upload` for a full list of flags.
+### Uploading dependent changes
+
+If you wish to work on multiple related changes without waiting for
+them to land, you can do so in Gerrit using dependent changes.
+
+To put this into an example, let‘s say you have a commit for feature A
+and this is in the process of being reviewed on Gerrit. Now let’s say
+you want to start more work based on it before it lands on main.
+
+```
+git checkout featureA
+git checkout -b featureB
+git branch --set-upstream-to featureA
+# ... edit some files
+# ... git add ...
+git commit
+git cl upload
+```
+
+In Gerrit, there would then be a “relation chain” shown where the
+feature A change is the parent of the feature B change. If A
+introduces a new file which B changes, the review for B will only show
+the diff from A.
+
## Code review
Code reviews are covered in more detail on the [code review
