Update 3.10 release notes for rc2
Change-Id: I2ed531a34051c0ff9652351a00f0de573cadc617
diff --git a/pages/site/releases/3.10.md b/pages/site/releases/3.10.md
index 4eadc21..8c75bb4 100644
--- a/pages/site/releases/3.10.md
+++ b/pages/site/releases/3.10.md
@@ -6,12 +6,18 @@
toc: true
---
+Download: **[3.10.0-rc2](https://gerrit-releases.storage.googleapis.com/gerrit-3.10.0-rc2.war)**
+
+Documentation: **[3.10.0-rc2](http://gerrit-documentation.storage.googleapis.com/Documentation/3.10.0-rc2/index.html)**
+
## Release highlights
### Rebase merge commits
+
It's now possible to rebase merge commits directly from the UI.
### Further improve Suggest Fixes
+
It's now possible to have plugin generated suggested fixes directly in the
UI. This opens the door for AI integration in the review process with Gerrit
Code Review.
@@ -20,15 +26,18 @@
[here](https://gerrit-review.googlesource.com/Documentation/user-suggest-edits.html)
### Import changes from other servers
+
Imported projects from other servers is now fully supported, including also
queries by change number on Lucene.
### List enabled features/experiments via REST API
+
It's now possible to list all experiments currently enabled on a Gerrit server
by hitting the `config/server/experiments` endpoint. Please see more details
[here](https://gerrit-review.googlesource.com/Documentation/rest-api-config.html#list-experiments)
### Index management is now more accessible
+
A number of rest endpoints have been added to simplify management and
observability of Gerrit indexes. It's now possible to:
- [List
@@ -44,12 +53,13 @@
It is also possible to specify whether to re-use up-to-date index documents.
### Less email notifications
+
Attention has been put on reducing the number of email notifications that Gerrit
users receive even when no actions need to be taken.
- Gerrit no longer send emails to everyone when additional reviewers or CCs are
added. Please note, this is also a breaking change, see more details on the
- change, [Change 400822](https://gerrit-review.googlesource.com/400822)
+ change, [Change 400822](https://gerrit-review.googlesource.com/400822).
- Only add owner and uploader to the attention set if the label is copied over to
the latest patchset, avoiding emails for votes on older patchsets that don't
@@ -60,26 +70,29 @@
emails than intended.
### Support project~changeNumber when querying for changes
+
So far querying changes using the `change:` predicate did not
allow to use the `project~changeNumber` format. However, since
-[Change 387794](https://gerrit-review.googlesource.com/c/gerrit/+/387794) this is the default ID
-format returned in the ChangeInfo. Being able to use it directly for
-further queries would be advantageous.
+[Change 387794](https://gerrit-review.googlesource.com/c/gerrit/+/387794)
+this is the default ID format returned in the ChangeInfo. Being able to
+use it directly for further queries would be advantageous.
-i.e. https://gerrit-review.googlesource.com/q/change:gerrit~399319
+i.e. `https://gerrit-review.googlesource.com/q/change:gerrit~399319`
-This reinforces the concept that `project~changeNumber` should be the Id to use
-when trying to unique identify changes. This should be preferred to
+This reinforces the concept that `project~changeNumber` should be the Id to
+use when trying to unique identify changes. This should be preferred to
`project~branch~changeId` as this can theoretically contain duplicates, as
specified in [Issue 313935024](https://issues.gerritcodereview.com/issues/313935024)
### Configurable H2 cache pruning
+
Schedule of cache pruning of H2 caches is now configurable. This means that it
doesn't necessarily need to run on startup, therefore improving Gerrit startup
times. Find more information in the
[docs](https://gerrit-review.googlesource.com/Documentation/config-gerrit.html#cachePruning).
### Improved H2 Cache performances
+
Indexes have been added to the H2 cache databases, greatly improving performance
of persistent caches, especially pruning and building bloom filters.
@@ -87,10 +100,10 @@
Robot Comments have been officially deprecated for some time and the [checks API
framework](https://gerrit-review.googlesource.com/Documentation/pg-plugin-checks-api.html)
-is recommended since Gerrit 3.6. This is great as it provides a way of greatly
-reducing the size of the repository. However, unlike fixes suggested in
-Robot-Comments, Human Suggested fixes could not be applied programmatically,
-until now.
+is recommended since Gerrit 3.6. This is great as it provides a way of
+greatly reducing the size of the repository. However, unlike fixes
+suggested in Robot-Comments, Human Suggested fixes could not be applied
+programmatically, until now.
Gerrit 3.10 introduces a way of suggesting fixes that could then be
programmatically applied with the the [Apply Stored
@@ -126,10 +139,17 @@
the UI.
## Important Notes
-* [Change 394841](https://gerrit-review.googlesource.com/394841) The commit-msg
- hook now operates as a no-op for temporary commits, which are identified by a
- lowercase word followed by an exclamation mark (e.g., fixup!, squash!).
+* [Change 394841](https://gerrit-review.googlesource.com/394841):
+The commit-msg hook now operates as a no-op for temporary commits, which
+are identified by a lowercase word followed by an exclamation mark (e.g.,
+fixup!, squash!).
+
Configure gerrit.createChangeId to 'always' to force creation on these cases.
+* [Change 394841](https://gerrit-review.googlesource.com/418257) Introduce
+ server_id in change_notes cache and update its version number.
+
+ This means that if you're using the change_notes cache, the file needs to be
+ deleted. It will be automatically regenerated.
### Submit Requirement Changes
* [Change 396517](https://gerrit-review.googlesource.com/396517) allow a
@@ -192,84 +212,107 @@
### Breaking Changes
-* [Change 409738](https://gerrit-review.googlesource.com/409738) Added
- validation for label copy conditions
-* [Change 407417](https://gerrit-review.googlesource.com/407417) Branch links
- in change metadata now ignore status
+* [Change 409738](https://gerrit-review.googlesource.com/409738):
+Added validation for label copy conditions
+
+* [Change 407417](https://gerrit-review.googlesource.com/407417):
+Branch links in change metadata now ignore status
This means that clicking the branch link in the change detail section returns
all changes associated with that branch, rather than the ones matching the
change's status. This will return a much greater number of changes than
before, potentially impacting plugin/workflow performance.
-* [Change 404717](https://gerrit-review.googlesource.com/404717 )Deprecate review
- command without project argument
+
+* [Change 404717](https://gerrit-review.googlesource.com/404717):
+Deprecate review command without project argument
+
* [Issue 325070428](https://crbug.com/gerrit/325070428) Added new
- current_revision_number field to ChangeInfo that contains the current patch
- set number
+`current_revision_number` field to ChangeInfo that contains the current
+patch set number
If the consumer is "well designed" adding one extra field in the JSON response
should not break any existing behaviour. However, as it's a change in the
response payload, we're highlighting this as potentially breaking change.
-* [Change 400821](https://gerrit-review.googlesource.com/400821)
- AutoMerger#lookupFromGitOrMergeInMemory: Remove mergeStrategy parameter
+
+* [Change 400821](https://gerrit-review.googlesource.com/400821):
+`AutoMerger#lookupFromGitOrMergeInMemory`: Remove mergeStrategy parameter
This only impacts plugins.
+
* [Change 401198](https://gerrit-review.googlesource.com/401198) DiffOperations:
- Remove unused diffOptions parameter from load methods
+Remove unused diffOptions parameter from load methods
Potentially breaking change as it impacts plugins that use the DiffOperations
interface.
* [Deprecated robot-comments](#deprecated-robot-comments)
-* [Change 401977](https://gerrit-review.googlesource.com/401977) Use
- RetryScheduler with backoff when server returns 429
+* [Change 401977](https://gerrit-review.googlesource.com/401977):
+Use `RetryScheduler` with backoff when server returns 429
Gerrit UI will now automatically retry the Rest API calls to the backend when
the HTTP status code is 429. This could lead to duplicated requests sent to
the backend and consequently higher load on the system.
-* [Change 396859](https://gerrit-review.googlesource.com/396859) Disable
- dropdown items for downlading files >50 MB
+* [Change 396859](https://gerrit-review.googlesource.com/396859):
+Disable dropdown items for downlading files >50 MB
The 50MB limit is hardcoded and cannot be changed via configuration.
### Other changes
-* [Change 409729](https://gerrit-review.googlesource.com/409729) Added REST
- endpoint to get the commit message of a change
-* [Change 391494](https://gerrit-review.googlesource.com/391494) committer and
- author identities can be updated in change edit mode via REST
-* [Change 394795](https://gerrit-review.googlesource.com/394795) Remove
- ActionType, ChangeActions and RevisionActions enums forwarded as properties
- from ChangeActionsPluginApi implementation
-* [Issue 240676565](https://crbug.com/gerrit/240676565) Reviewer updates for
- reviewers by email are returned in change details
-* [Issue 326096919](https://crbug.com/gerrit/326096919) Fixed internal server
- error when posting a review with a ReviewerInput that didn't set the
- 'reviewer' field.
-* [Change 412617](https://gerrit-review.googlesource.com/412617) Fix bug that
- allows inserting a broken pack
-* [Change 413077](https://gerrit-review.googlesource.com/413077) Plugins can use
- VersionedConfigFile to read/write a config file stored in git
-* [Change 399657](https://gerrit-review.googlesource.com/399657) Fix WorkQueue
- bug to ensure reliable execution of scheduled tasks
-* [Change 392460](https://gerrit-review.googlesource.com/392460) Added commit
- sha and change number to "commit already exists (in change)" Push Rejected
- response.
-* [Change 399237](https://gerrit-review.googlesource.com/399237) Improved
- WorkQueue task thread names
-* [Change 412438](https://gerrit-review.googlesource.com/412438) Fix behavior of
- rules.enable config to disable prolog
+
+* [Change 409729](https://gerrit-review.googlesource.com/409729):
+Added REST endpoint to get the commit message of a change
+
+* [Change 391494](https://gerrit-review.googlesource.com/391494):
+Committer and author identities can be updated in change edit mode via REST
+
+* [Change 394795](https://gerrit-review.googlesource.com/394795):
+Remove ActionType, ChangeActions and RevisionActions enums forwarded as
+properties from ChangeActionsPluginApi implementation
+
+* [Issue 240676565](https://crbug.com/gerrit/240676565):
+Reviewer updates for reviewers by email are returned in change details
+
+* [Issue 326096919](https://crbug.com/gerrit/326096919):
+Fixed internal server error when posting a review with a ReviewerInput
+that didn't set the `reviewer` field
+
+* [Change 412617](https://gerrit-review.googlesource.com/412617):
+Fix bug that allows inserting a broken pack
+
+* [Change 413077](https://gerrit-review.googlesource.com/413077):
+Plugins can use `VersionedConfigFile` to read/write a config file stored in git
+
+* [Change 399657](https://gerrit-review.googlesource.com/399657):
+Fix `WorkQueue` bug to ensure reliable execution of scheduled tasks
+
+* [Change 392460](https://gerrit-review.googlesource.com/392460):
+Added commit sha and change number to "commit already exists (in change)"
+Push Rejected response.
+
+* [Change 399237](https://gerrit-review.googlesource.com/399237):
+Improved WorkQueue task thread names
+
+* [Change 412438](https://gerrit-review.googlesource.com/412438):
+Fix behavior of rules.enable config to disable prolog
+
+* [Change 419157](https://gerrit-review.googlesource.com/419157) Solves a
+ latency regression related to CallerFinder
## Other Changes related to Multi-Site
-* [Change 399618](https://gerrit-review.googlesource.com/399618) Populate
- project-created event with instanceId
-* [Change 398918](https://gerrit-review.googlesource.com/398918) Don't fire
- project-created events not produced locally
-* [Change 417000](https://gerrit-review.googlesource.com/417000) Allow to
- reindex changes without notifying listeners
-* [Change 413257](https://gerrit-review.googlesource.com/413257) Allow listing
- tags in descending order
+
+* [Change 399618](https://gerrit-review.googlesource.com/399618):
+Populate `project-created` event with `instanceId`
+
+* [Change 398918](https://gerrit-review.googlesource.com/398918):
+Don't fire `project-created` events not produced locally
+
+* [Change 417000](https://gerrit-review.googlesource.com/417000):
+Allow to reindex changes without notifying listeners
+
+* [Change 413257](https://gerrit-review.googlesource.com/413257):
+Allow listing tags in descending order
## Plugin changes
- codemirror-editor updated to: d4f9247d3efb6a0e461af701986235511d05b7e3
@@ -279,7 +322,7 @@
- gitiles updated to: 4e8bd706e87eb11e3cfe2bfa9bbcb29020f39482
- hooks updated to: f975f914312b258f84957d19f96014c3edd12644
- plugin-manager updated to: cdd2d2d69666a70a16ac02bacf8e7fbbf4ca9979
-- replication updated to: 012f04240eafe6dfa21fd94e012e97498881c621
+- replication updated to: 56b8ffbab5bf619c0b6b5d44f0255fd41b9e1c89
- reviewnotes updated to: 18c867b6a957b3ddeb7a9e9789819fc60bdcd99a
- singleusergroup updated to: 4bee62cbbc21979b841843dd5faaf79470a35966
- webhooks updated to: 2e5ec3b3bcf5e7ba50edba9eca3c15c8057ad6c2
@@ -326,6 +369,12 @@
* f93ccb7fd RebaseCommand: return correct status on stash apply conflicts
* 42917767f UploadPack: Delay freeing refs in sendPack()
+## Security Fixes
+* [Issue 321784734](https://gerrit-review.googlesource.com/q/bug:321784734) Fix
+ endless loop when using "is:watched" in project watches.
+
+ Previous setting up email notification with `is:watched` predicate would
+ create an infinite loop that would take a CPU offline.
## Documentation changes
* [Issue 312899496](https://gerrit-review.googlesource.com/q/bug:312899496)
@@ -351,72 +400,102 @@
## Other dependency changes
-* [Change 389854](https://gerrit-review.googlesource.com/389854) Update protobuf
- version to 21.7
-* [Change 408697](https://gerrit-review.googlesource.com/408697) update Soy
- library
-* [Change 387360](https://gerrit-review.googlesource.com/387360) Update Bazel
- version to 7.0.0
-* [Change 391534](https://gerrit-review.googlesource.com/391534) Bazel: Add
- support for JDK 21
-* [Issue 319778767,](https://crbug.com/gerrit/319778767,) Update
- commons-compress to 1.25.0
-* [Change 399557](https://gerrit-review.googlesource.com/399557) Update reload4j
- to 1.2.25
-* [Issue 317782004](https://crbug.com/gerrit/317782004) Update httpcore to
- 4.4.16
-* [Issue 317790747](https://crbug.com/gerrit/317790747) Update auto-value to
- 1.10.4
-* [Issue 317782000](https://crbug.com/gerrit/317782000) Update httpclient to
- 4.5.14
-* [Change 400697](https://gerrit-review.googlesource.com/400697) Upgrade yarn
- deps (January 2024)
-* [Change 412497](https://gerrit-review.googlesource.com/412497) Update Truth to
- 1.4.2.
+* [Change 389854](https://gerrit-review.googlesource.com/389854):
+Update protobuf version to 21.7
+
+* [Change 408697](https://gerrit-review.googlesource.com/408697):
+update Soy library
+
+* [Change 387360](https://gerrit-review.googlesource.com/387360):
+Update Bazel version to 7.0.0
+
+* [Change 391534](https://gerrit-review.googlesource.com/391534):
+Bazel: Add support for JDK 21
+
+* [Issue 319778767,](https://crbug.com/gerrit/319778767):
+Update commons-compress to 1.25.0
+
+* [Change 399557](https://gerrit-review.googlesource.com/399557):
+Update reload4j to 1.2.25
+
+* [Issue 317782004](https://crbug.com/gerrit/317782004):
+Update httpcore to 4.4.16
+
+* [Issue 317790747](https://crbug.com/gerrit/317790747):
+Update auto-value to 1.10.4
+
+* [Issue 317782000](https://crbug.com/gerrit/317782000):
+Update httpclient to 4.5.14
+
+* [Change 400697](https://gerrit-review.googlesource.com/400697):
+Upgrade yarn deps (January 2024)
+
+* [Change 412497](https://gerrit-review.googlesource.com/412497):
+Update Truth to 1.4.2.
## Frontend changes
-* [Issue 315957653](https://crbug.com/gerrit/315957653) account-chip hover-card
- shows correct email for author and committer
-* [Change 397457](https://gerrit-review.googlesource.com/397457) Add syntax
- highlight support for cjs, cts, and mts file
-* [Change 400824](https://gerrit-review.googlesource.com/400824) Fix scrolling
- to diff rows covered by the header UI
-* [Change 402837](https://gerrit-review.googlesource.com/402837) Revert CLs
-should still say Ready To Submit UI supports updating commit message using a
-registered secondary email
-* [Change 407157](https://gerrit-review.googlesource.com/407157) Add plugin
- endpoint for account links
-* [Change 407660](https://gerrit-review.googlesource.com/407660) Turn Reply
- button into Sign in button when logged out
-* [Change 407820](https://gerrit-review.googlesource.com/407820) Improve
- reviewer autocomplete on restricted refs/branches
-* [Change 407823](https://gerrit-review.googlesource.com/407823) Show checks
- findings on file list
-* [Change 407825](https://gerrit-review.googlesource.com/407825) Prevent pencil
- wrapping by itself in change metadata
-* [Issue 40015337](https://crbug.com/gerrit/40015337) Fix browser BACK button
- when going to plugin pages
-* [Change 416260](https://gerrit-review.googlesource.com/416260) Diff processor
- was simplified. It does not split up into multiple async chunks of work
- anymore.
-* [Change 396859](https://gerrit-review.googlesource.com/396859) Disable
- dropdown items for downlading files >50 MB
-* [Change 401384](https://gerrit-review.googlesource.com/401384) Stop
- considering combo key after first hit
-* [Change 403277](https://gerrit-review.googlesource.com/403277) Only show the
- "Show Blame" button if blame is enabled.
-* [Change 416001](https://gerrit-review.googlesource.com/416001) Add a
- `replysent` plugin event
-* [Change 411358](https://gerrit-review.googlesource.com/411358) Fix revision
- actions constantly showing as "loading" when not signed in
-* [Issue 40004507](https://crbug.com/gerrit/40004507) Added support for
- filtering branches/tags in plugins.
-* [Issue 330574510](https://crbug.com/gerrit/330574510) Fix issue with
- gr-file-list-header not working correctly after writing a comment
-* [Change 394446](https://gerrit-review.googlesource.com/394446) fix tabbing for
- non-emojis starting with colon
-* [Change 395461](https://gerrit-review.googlesource.com/395461) Fix emoji
- selector for all keys
-* [Change 399797](https://gerrit-review.googlesource.com/399797) Enable
- highlighting for Qt code components
+* [Issue 315957653](https://crbug.com/gerrit/315957653):
+account-chip hover-card shows correct email for author and committer
+
+* [Change 397457](https://gerrit-review.googlesource.com/397457):
+Add syntax highlight support for cjs, cts, and mts file
+
+* [Change 400824](https://gerrit-review.googlesource.com/400824):
+Fix scrolling to diff rows covered by the header UI
+
+* [Change 402837](https://gerrit-review.googlesource.com/402837):
+Revert CLs should still say Ready To Submit UI supports updating commit
+message using a registered secondary email
+
+* [Change 407157](https://gerrit-review.googlesource.com/407157):
+Add plugin endpoint for account links
+
+* [Change 407660](https://gerrit-review.googlesource.com/407660):
+Turn Reply button into Sign in button when logged out
+
+* [Change 407820](https://gerrit-review.googlesource.com/407820):
+Improve reviewer autocomplete on restricted refs/branches
+
+* [Change 407823](https://gerrit-review.googlesource.com/407823):
+Show checks findings on file list
+
+* [Change 407825](https://gerrit-review.googlesource.com/407825):
+Prevent pencil wrapping by itself in change metadata
+
+* [Issue 40015337](https://crbug.com/gerrit/40015337):
+Fix browser BACK button when going to plugin pages
+
+* [Change 416260](https://gerrit-review.googlesource.com/416260):
+Diff processor was simplified. It does not split up into multiple async
+chunks of work anymore.
+
+* [Change 396859](https://gerrit-review.googlesource.com/396859):
+Disable dropdown items for downlading files >50 MB
+
+* [Change 401384](https://gerrit-review.googlesource.com/401384):
+Stop considering combo key after first hit
+
+* [Change 403277](https://gerrit-review.googlesource.com/403277):
+Only show the _Show Blame_ button if blame is enabled.
+
+* [Change 416001](https://gerrit-review.googlesource.com/416001):
+Add a `replysent` plugin event
+
+* [Change 411358](https://gerrit-review.googlesource.com/411358):
+Fix revision actions constantly showing as "loading" when not signed in
+
+* [Issue 40004507](https://crbug.com/gerrit/40004507):
+Added support for filtering branches/tags in plugins
+
+* [Issue 330574510](https://crbug.com/gerrit/330574510):
+Fix issue with `gr-file-list-header` not working correctly after writing a comment
+
+* [Change 394446](https://gerrit-review.googlesource.com/394446):
+fix tabbing for non-emojis starting with colon
+
+* [Change 395461](https://gerrit-review.googlesource.com/395461):
+Fix emoji selector for all keys
+
+* [Change 399797](https://gerrit-review.googlesource.com/399797):
+Enable highlighting for Qt code components
\ No newline at end of file
