Document when pushing an initial commit for review is possible
Bug: Google b/353568634
Release-Notes: skip
Change-Id: Id001683af04baeb64beac0422e47ba51a087c983
Signed-off-by: Edwin Kempin <ekempin@google.com>
diff --git a/Documentation/user-upload.txt b/Documentation/user-upload.txt
index 625c2e9..7cc9e29 100644
--- a/Documentation/user-upload.txt
+++ b/Documentation/user-upload.txt
@@ -205,6 +205,15 @@
notify them of new changes will be automatically sent an email
message when the push is completed.
+Pushing for review requires that the target branch exists, except for
+the branch to which "HEAD" points, e.g. "master", and the
+"link:config-project-config.html#refs-meta-config[refs/meta/config]"
+branch that contains the link:config-project-config.html[project
+configuration]. For these branches Gerrit allows pushing an initial
+commit for review even if they don't exist yet. The push creates a
+change for the initial commit and when this change gets submitted the
+target branch gets created automatically.
+
[[push_options]]
=== Push Options
