diff --git a/docs/source/upgrade-guide/index.md b/docs/source/upgrade-guide/index.md
index 8ef51b8347..c4256e1304 100644
--- a/docs/source/upgrade-guide/index.md
+++ b/docs/source/upgrade-guide/index.md
@@ -30,7 +30,9 @@ Thus it is safe to run it on top of your project and answer the prompts.
 
 ### ESlint project configuration update
 
-Since `@plone/registry` and other Volto dependencies packages are now released as standalone, it is needed to update some configurations files from your projects. In `.eslintrc.js`:
+`@plone/registry` and [other packages on which Volto depends](https://github.com/plone/volto/tree/main/packages) are now stand-alone releases in the monorepo structure released in 18.0.0-alpha.4.
+
+You must update the configuration file {file}`.eslintrc.js` in your projects, according to the following `git diff` patch.
 
 ```diff
 @@ -18,9 +19,6 @@ if (configFile) {
diff --git a/packages/generator-volto/news/5530.bugfix b/packages/generator-volto/news/5530.bugfix
index 011ff0a10e..282b87664b 100644
--- a/packages/generator-volto/news/5530.bugfix
+++ b/packages/generator-volto/news/5530.bugfix
@@ -1 +1 @@
-Fixed generator ESlint config. Added tests and docs. @sneridagh
+Fixed the project generator's ESLint configuration, added code quality checks to the CI to ensure a generated project can run these checks, and added documentation for how to reconfigure ESLint in projects. @sneridagh
diff --git a/packages/volto/news/5530.bugfix b/packages/volto/news/5530.bugfix
index 94a905a310..282b87664b 100644
--- a/packages/volto/news/5530.bugfix
+++ b/packages/volto/news/5530.bugfix
@@ -1 +1 @@
-Do not pin the `eslint-plugin-jsx-a11y` version in Volto. Fixed generator ESlint config. Added tests and docs. @sneridagh
+Fixed the project generator's ESLint configuration, added code quality checks to the CI to ensure a generated project can run these checks, and added documentation for how to reconfigure ESLint in projects. @sneridagh