Highlight known-issues on Gerrit v3.8
Gerrit v3.8 has been shipped with two known critical issues:
- Change 360646, caused a radical change in the way Gerrit threads
are handling the updates of the ref-database, leading to potential
corruption in multi-site and concurrent GCs
- Issue 40015537, causing Gerrit to render a complete blank page on
certain browsers that have been working fine until v3.7.x
Introduce the "Known issues" section, visually close to the
"Breaking changes" to warn the Gerrit administrator about the potential
breakages that he may encounter when migrating to Gerrit v3.8.x.
The Gerrit administrator can therefore make the necessary adjustments to
the environment and client browsers for preventing the known issues to
impact the users after the upgrade.
Bug: Issue 309098227
Bug: Issue 40015537
Change-Id: I83d7dc34563e381a8b6b7bb82ec820063cc0e16b
diff --git a/pages/site/releases/3.8.md b/pages/site/releases/3.8.md
index 73d6d74..dc3fb59 100644
--- a/pages/site/releases/3.8.md
+++ b/pages/site/releases/3.8.md
@@ -181,15 +181,29 @@
e.g. change https://bugs.chromium.org/p/gerrit/issues/entry?template=Bug+Report
to https://issues.gerritcodereview.com/issues/new.
-### Breaking changes
+### Known issues
-* [Issue 16942](https://crbug.com/gerrit/16942):
+* [Issue 309098227](https://issues.gerritcodereview.com/issues/309098227) [Change 360646](https://gerrit-review.googlesource.com/360646):
+The introducion a per request ref cache for better performance may break
+the repository consistency
+
+ The addition of a new `core.usePerRequestRefCache` setting, true by
+ default, introduced a per request (currently per request thread) ref
+ cache, helping reduce the overhead of checking if the packed-refs file
+ was outdated. However, in some scenarios, such as multi-site or
+ concurrency between `git-receive-pack` and `git-gc`, it may lead to
+ split-brain inconsistencies and, in the worst-case scenario, to the
+ corruption of the underlying repository.
+
+* [Issue 40015537](https://issues.gerritcodereview.com/issues/40015537):
Gerrit does not render properly the modal dialogs on Safari 15.3, Chrome 36, Edge 78, and Firefox 97
or earlier.
Gerrit frontend uses the [HTMLDialogElement.showModal](https://developer.mozilla.org/en-US/docs/Web/API/HTMLDialogElement/showModal)
function, which is not working properly on old browsers.
+### Breaking changes
+
* [Change 365595](https://gerrit-review.googlesource.com/365595):
WebLinkInfo: Drop deprecated constructor
