upgrade notes

Author: petschki

docs/templates/addon/theme_barceloneta/index.rst

@@ -32,3 +32,18 @@ These packages are optional but recommended to have support for configuration an
 
 Themes which are supporting these additional functionality are called ``Extended Themes``.
 
+
+Upgrade notes
+=============
+
+Starting with version `6.3.x` we provide the latest `@plone/plonetheme-barceloneta-base==3.1.x` which
+depends on Bootstrap 5.3 and adds the new "color mode" feature.
+
+If you have generated a `theme_barceloneta` with version 6.2.x (Bootstrap 5.2.x) you can
+easily update your theme to Bootstrap 5.3 with the following steps:
+
+  1. pin `"@plone/plonetheme-barceloneta-base": "~3.1.0"` in you `package.json`
+  2. install cleanly with `rm -rf node_modules package-lock.json && npm install` in your theme folder
+  3. Fix your theme imports by adding the following lines to your `theme/styles/theme.scss`:
+     `adding Bootstrap 5.3 color mode imports <https://github.com/plone/bobtemplates.plone/pull/550/commits/e61c34439582eac2b52fab15327c849a69e6da05?diff=unified&w=1>`_
+  4. compile your css with `npm run build`