5822cb3433
Change-Id: Ibc95e2feb3a2b6667678838c04c49cd0764c0f05 Signed-off-by: Edwin Kempin <ekempin@google.com>
92 lines
2.9 KiB
Plaintext
92 lines
2.9 KiB
Plaintext
= Gerrit Code Review - Stars
|
|
|
|
== Description
|
|
|
|
Changes can be starred with labels that behave like private hashtags.
|
|
Any label can be applied to a change, but these labels are only visible
|
|
to the user for which the labels have been set.
|
|
|
|
Stars allow users to categorize changes by self-defined criteria and
|
|
then build link:user-dashboards.html[dashboards] for them by making use
|
|
of the link:#query-stars[star query operators].
|
|
|
|
[[star-api]]
|
|
== Star API
|
|
|
|
The link:rest-api-accounts.html#star-endpoints[star REST API] supports:
|
|
|
|
* link:rest-api-accounts.html#get-stars[
|
|
get star labels from a change]
|
|
* link:rest-api-accounts.html#set-stars[
|
|
update star labels on a change]
|
|
* link:rest-api-accounts.html#get-starred-changes[
|
|
list changes that are starred by any label]
|
|
|
|
Star labels are also included in
|
|
link:rest-api-changes.html#change-info[ChangeInfo] entities that are
|
|
returned by the link:rest-api-changes.html[changes REST API].
|
|
|
|
There are link:rest-api-accounts.html#default-star-endpoints[
|
|
additional REST endpoints] for the link:#default-star[default star].
|
|
|
|
Only the link:#default-star[default star] is shown in the WebUI and
|
|
can be updated from there. Other stars do not show up in the WebUI.
|
|
|
|
[[default-star]]
|
|
== Default Star
|
|
|
|
If the default star is set by a user, this user is automatically
|
|
notified by email whenever updates are made to that change.
|
|
|
|
The default star is the star that is shown in the WebUI and which can
|
|
be updated from there.
|
|
|
|
The default star is represented by the special star label 'star'.
|
|
|
|
[[ignore-star]]
|
|
== Ignore Star
|
|
|
|
If the ignore star is set by a user, this user gets no email
|
|
notifications for updates of that change, even if this user is a
|
|
reviewer of the change or the change is matched by a project watch of
|
|
the user.
|
|
|
|
Since changes can only be ignored once they are created, users that
|
|
watch a project will always get the email notifications for the change
|
|
creation. Only then the change can be ignored.
|
|
|
|
Users that are added as reviewer or assignee to a change that they have
|
|
ignored will be notified about this, so that they know about the review
|
|
request. They can then decide to remove the ignore star.
|
|
|
|
The ignore star is represented by the special star label 'ignore'.
|
|
|
|
[[query-stars]]
|
|
== Query Stars
|
|
|
|
There are several query operators to find changes with stars:
|
|
|
|
* link:user-search.html#star[star:<LABEL>]:
|
|
Matches any change that was starred by the current user with the
|
|
label `<LABEL>`.
|
|
* link:user-search.html#has-stars[has:stars]:
|
|
Matches any change that was starred by the current user with any
|
|
label.
|
|
* link:user-search.html#is-starred[is:starred] /
|
|
link:user-search.html#has-star[has:star]:
|
|
Matches any change that was starred by the current user with the
|
|
link:#default-star[default star].
|
|
|
|
[[syntax]]
|
|
== Syntax
|
|
|
|
Star labels cannot contain whitespace characters. All other characters
|
|
are allowed.
|
|
|
|
GERRIT
|
|
------
|
|
Part of link:index.html[Gerrit Code Review]
|
|
|
|
SEARCHBOX
|
|
---------
|