Document that external-ids paths variably nested

The documentation shows gerrit admins how to view external-id notes in
All-Users. The examples show a single level of dir nesting with the
resulting sha1. In reality these may be nested deeper. Add a note to
the docs to make this more clear.

Change-Id: If598dcd9edc66264efea34a931b01d6133f95e88
This commit is contained in:
Clark Boylan
2020-11-23 13:10:41 -08:00
parent 980a8f0d1b
commit a888eec9a0

View File

@@ -343,6 +343,12 @@ subsection name.
The `accountId` field is mandatory. The `email` and `password` fields
are optional.
Note that git will automatically nest these notes at varying levels. If
refs/meta/external-ids:7c/2a55657d911109dbc930836e7a770fb946e8ef is not
found then check
refs/meta/external-ids:7c/2a/55657d911109dbc930836e7a770fb946e8ef and
so on.
The external IDs are maintained by Gerrit. This means users are not
allowed to manually edit their external IDs. Only users with the
link:access-control.html#capability_accessDatabase[Access Database]