summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorJeremy Bettis <jbettis@google.com>2023-01-26 16:34:43 -0700
committerChromeos LUCI <chromeos-scoped@luci-project-accounts.iam.gserviceaccount.com>2023-01-27 17:04:02 +0000
commit309c2601586628bdda6c1ab3c644945a4959ce16 (patch)
tree128b88c4e78cb4297007f919f65526ef67cb28b0 /docs
parent196d7f79f877220cde5874373d297fa0db1d3a1c (diff)
downloadchrome-ec-309c2601586628bdda6c1ab3c644945a4959ce16.tar.gz
docs: Add doc for pupr
Add a doc explaining what to do with pupr cls. BRANCH=None BUG=b:261258378 TEST=None Change-Id: Idf2cc0d26f225056ba5e9d841626cb9a6101f42a Signed-off-by: Jeremy Bettis <jbettis@google.com> Reviewed-on: https://chromium-review.googlesource.com/c/chromiumos/platform/ec/+/4198453 Auto-Submit: Jeremy Bettis <jbettis@chromium.org> Reviewed-by: Keith Short <keithshort@chromium.org> Commit-Queue: Keith Short <keithshort@chromium.org> Tested-by: Jeremy Bettis <jbettis@chromium.org>
Diffstat (limited to 'docs')
-rw-r--r--docs/pupr.md19
-rw-r--r--docs/sitemap.md1
2 files changed, 20 insertions, 0 deletions
diff --git a/docs/pupr.md b/docs/pupr.md
new file mode 100644
index 0000000000..bb7d110bae
--- /dev/null
+++ b/docs/pupr.md
@@ -0,0 +1,19 @@
+# Parallel Uprevs for platform/ec
+
+## Overview
+
+Since the platform/ec repo doesn't use the normal ebuild based CQ some of the
+ebuild files don't use the normal automatic uprev. Instead the go/pupr tool
+creates new CLs to uprev the chromeos-base/ec-utils and send them through the
+slow CQ running all the ebuilds that depend on it.
+
+## Reviewer responsibilities
+
+For the most part you can ignore these CLs. You don't need to add CR+2 nor CQ+2.
+However if you see that the CL has failed the CQ several times, you should
+check and see if there is a real bug that is preventing the CL from submitting.
+
+## Failure implications
+
+If the CL fails to merge, then the ectool binary will not be built with the
+latest code.
diff --git a/docs/sitemap.md b/docs/sitemap.md
index 0bdc3ede12..1d9b2b3cb4 100644
--- a/docs/sitemap.md
+++ b/docs/sitemap.md
@@ -77,6 +77,7 @@
* [Code Reviews](./code_reviews.md)
* [IDE Support](./ide-support.md)
* [Building with Goma (Googlers only)](./goma.md)
+* [Parallel Uprevs for ebuilds](./pupr.md)
[1]:https://chromium.googlesource.com/chromiumos/platform/ec/+/cr50_stab/docs/case_closed_debugging.md
[2]:https://chromium.googlesource.com/chromiumos/platform/ec/+/cr50_stab/docs/case_closed_debugging_cr50.md