Merge branch '6.0' into dev-guide-create-a-backend-add-on

erral · web-flow · commit af2689a06e5c · 2025-12-01T15:48:47.000+01:00
diff --git a/docs/backend/relations.md b/docs/backend/relations.md
@@ -61,7 +61,7 @@ minions = RelationList(
 )
 ```
 
-We can see that the [code for the behavior `IRelatedItems`](https://github.com/plone/plone.app.relationfield/blob/master/plone/app/relationfield/behavior.py) does exactly the same thing.
+We can see that the [code for the behavior `IRelatedItems`](https://github.com/plone/plone.app.relationfield/blob/master/src/plone/app/relationfield/behavior.py) does exactly the same thing.
 
 
 (relations-controlling-relation-targets-label)=
diff --git a/docs/backend/upgrading/version-specific-migration/upgrade-to-python3.md b/docs/backend/upgrading/version-specific-migration/upgrade-to-python3.md
@@ -382,6 +382,6 @@ Here is a list of helpful references on the topic of porting Python 2 to Python
 -   https://eev.ee/blog/2016/07/31/python-faq-how-do-i-port-to-python-3/
 -   https://diveintopython3.net/
 -   https://docs.djangoproject.com/en/1.11/topics/python3/
--   https://docs.ansible.com/ansible/latest/dev_guide/developing_python_3.html
+-   https://docs.ansible.com/projects/ansible/latest/dev_guide/developing_python_3.html
 -   https://docs.python.org/2/library/doctest.html#debugging
 ```
diff --git a/docs/backend/widgets.md b/docs/backend/widgets.md
@@ -624,7 +624,7 @@ You can set the template used by the widget with the `<z3c:widgetTemplate>` ZCML
 ### Widget frame override
 
 You can override widget templates as instructed for `z3c.form`.
-`plone.app.z3cform` renders [a frame around each widget](https://github.com/plone/plone.app.z3cform/blob/master/plone/app/z3cform/templates/widget.pt), which usually consists of:
+`plone.app.z3cform` renders [a frame around each widget](https://github.com/plone/plone.app.z3cform/blob/master/src/plone/app/z3cform/templates/widget.pt), which usually consists of:
 
 -   Label
 -   Required marker
@@ -633,7 +633,7 @@ You can override widget templates as instructed for `z3c.form`.
 You might want to customize this widget frame for your own form.
 Below is an example of how to do it.
 
-Copy [`widget.pt`](https://github.com/plone/plone.app.z3cform/blob/master/plone/app/z3cform/templates/widget.pt) to your own package, rename it as `demo-widget.pt`, and edit it.
+Copy [`widget.pt`](https://github.com/plone/plone.app.z3cform/blob/master/src/plone/app/z3cform/templates/widget.pt) to your own package, rename it as `demo-widget.pt`, and edit it.
 
 Then add the following code to `configure.zcml`.
 Remember to fix the path of the template according to your own paths.
diff --git a/docs/classic-ui/forms.md b/docs/classic-ui/forms.md
@@ -174,7 +174,7 @@ In the template, you can use the following variables:
 Dexterity content types come with default add and edit forms.
 You can build custom add and edit forms to adjust their behavior.
 
-The implementation of the default edit and add forms is in [`plone.dexterity.browser.edit.py`](https://github.com/plone/plone.dexterity/blob/master/plone/dexterity/browser/edit.py) and [`plone.dexterity.browser.add.py`](https://github.com/plone/plone.dexterity/blob/master/plone/dexterity/browser/add.py).
+The implementation of the default edit and add forms is in [`plone.dexterity.browser.edit.py`](https://github.com/plone/plone.dexterity/blob/master/src/plone/dexterity/browser/edit.py) and [`plone.dexterity.browser.add.py`](https://github.com/plone/plone.dexterity/blob/master/src/plone/dexterity/browser/add.py).
 
 ```{todo}
 Describe Add/Edit forms here and how to customize them.
diff --git a/docs/classic-ui/images.md b/docs/classic-ui/images.md
@@ -248,7 +248,7 @@ To scale an image, you can use the `mode` parameter to control the scaling outpu
 You must use either `width` or `height`, or both.
 
 Three different scaling options are supported.
-They correspond to the CSS [`background-size`](https://developer.mozilla.org/en-US/docs/Web/CSS/background-size) values.
+They correspond to the CSS [`background-size`](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/background-size) values.
 
 The possible options for `mode` are listed below, where the default option is `scale`.
 
@@ -279,6 +279,7 @@ These views help developers verify image scaling, `srcset` generation, and explo
 These views work on image content types, including images and documents with images.
 
 Append the view name `/@@images-test` to an image URL, optionally followed by an anchor, such as `#srcset`, for specific sections.
+You must be authenticated as a site admin to view this demo.
 
 For example, on the Classic UI demo site, the URL would be https://classic.demo.plone.org/en/demo/an-image.jpg/@@images-test#srcset.
 
@@ -371,7 +372,7 @@ To access image scales, which are normally not accessible to the current user, o
 ## Responsive image support
 
 Plone supports the generation of [`picture`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/picture) tags with `srcset`s for image optimization.
-Additionally, you can define [media queries](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_media_queries/Using_media_queries) for [art direction](classic-ui-images-responsive-image-support-art-direction) and further optimization.
+Additionally, you can define [media queries](https://developer.mozilla.org/en-US/docs/Web/CSS/Guides/Media_queries/Using) for [art direction](classic-ui-images-responsive-image-support-art-direction) and further optimization.
 
 The configuration allows you to define different `picture` variants, such as `Large`, `Medium`, or `Small`.
 Users can choose from them in editors, such as TinyMCE, and developers can use them in templates.
diff --git a/docs/classic-ui/theming/css-custom-properties.md b/docs/classic-ui/theming/css-custom-properties.md
@@ -11,7 +11,7 @@ myst:
 
 # CSS custom properties
 
-This chapter describes the [CSS custom properties](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_cascading_variables/Using_CSS_custom_properties) used in Bootstrap and customized by Classic UI themes.
+This chapter describes the [CSS custom properties](https://developer.mozilla.org/en-US/docs/Web/CSS/Guides/Cascading_variables/Using_custom_properties) used in Bootstrap and customized by Classic UI themes.
 Custom properties (sometimes referred to as CSS variables or cascading variables) are entities defined by CSS authors that represent specific values to be reused throughout a document.
 
 
diff --git a/docs/classic-ui/viewlets.md b/docs/classic-ui/viewlets.md
@@ -190,7 +190,7 @@ These methods should honor the [`zope.contentprovider.interfaces.IContentProvide
 
 ```{seealso}
 -   [`zope.contentprovider.interfaces`](https://github.com/zopefoundation/zope.contentprovider/blob/3.7.2/src/zope/contentprovider/interfaces.py)
--   [`plone.app.layout.viewlets.common`](https://github.com/plone/plone.app.layout/blob/master/plone/app/layout/viewlets/common.py)
+-   [`plone.app.layout.viewlets.common`](https://github.com/plone/plone.app.layout/blob/master/src/plone/app/layout/viewlets/common.py)
 ```
 
 
@@ -822,7 +822,7 @@ Hide the concerning viewlets in one manager using `/@@manage-viewlets` and {file
 ```
 
 Viewlet managers are based on [`zope.viewlet.manager.ViewletManager`](https://github.com/zopefoundation/zope.viewlet/blob/master/src/zope/viewlet/manager.py)
-and [`plone.app.viewletmanager.manager.OrderedViewletManager`](https://github.com/plone/plone.app.viewletmanager/blob/master/plone/app/viewletmanager/manager.py).
+and [`plone.app.viewletmanager.manager.OrderedViewletManager`](https://github.com/plone/plone.app.viewletmanager/blob/master/src/plone/app/viewletmanager/manager.py).
 
 ```{seealso}
 -   [`zope.viewlet`](https://github.com/zopefoundation/zope.viewlet/blob/master/src/zope/viewlet/viewlet.py)
diff --git a/docs/classic-ui/views.md b/docs/classic-ui/views.md
@@ -38,7 +38,7 @@ This enhances readability and makes components more reusable.
 You can override the Python logic, the template file, or both.
 
 When you work with Plone, the most common view type is `BrowserView` from the package [`Products.Five`](https://github.com/zopefoundation/Zope/blob/master/src/Products/Five/doc/manual.txt).
-Other view types include `DefaultView` from [`plone.dexterity`](https://github.com/plone/plone.dexterity/blob/master/plone/dexterity/browser/view.py) and `CollectionView` from [`plone.app.contenttypes`](https://github.com/plone/plone.app.contenttypes/blob/master/plone/app/contenttypes/browser/collection.py).
+Other view types include `DefaultView` from [`plone.dexterity`](https://github.com/plone/plone.dexterity/blob/master/src/plone/dexterity/browser/view.py) and `CollectionView` from [`plone.app.contenttypes`](https://github.com/plone/plone.app.contenttypes/blob/master/src/plone/app/contenttypes/browser/collection.py).
 
 Each `BrowserView` class is a Python callable.
 The `BrowserView.__call__()` method acts as an entry point to executing the view code.
@@ -255,7 +255,7 @@ Add the name of the new view `my-view` to the following list:
 ### Template slots
 
 In the generated template above, we have a `fill-slot` attribute.
-This will fill the slot with the name `content-core`, which is defined in Plone's [`main_template`](https://github.com/plone/Products.CMFPlone/blob/master/Products/CMFPlone/browser/templates/main_template.pt).
+This will fill the slot with the name `content-core`, which is defined in Plone's [`main_template`](https://github.com/plone/Products.CMFPlone/blob/master/src/Products/CMFPlone/browser/templates/main_template.pt).
 The following list shows the available options for `<metal fill-slot="">` in your template.
 
 ```{note}
diff --git a/docs/conf.py b/docs/conf.py
@@ -88,7 +88,11 @@
     # Ignore pages that require authentication
     r"https://github.com/orgs/plone/teams/",
     r"https://github.com/plone/documentation/issues/new",
+    r"https://classic.demo.plone.org/en/demo/an-image.jpg/@@images-test#srcset",
+    # Ignore pages that are rate limited or otherwise blocked
     r"https://stackoverflow.com",
+    r"https://www.npmjs.com/",
+    r"https://hosted.weblate.org/",
     # Ignore github.com pages with anchors
     r"https://github.com/.*#.*",
     # Ignore rate limiting by github.com
diff --git a/docs/contributing/core/continuous-integration.md b/docs/contributing/core/continuous-integration.md
@@ -36,9 +36,9 @@ When you push a commit to a Plone repository on GitHub, the email address in you
 If it does not match, then `mr.roboto` will notify you that there is a problem that prevents your pull request from being merged.
 You must resolve the issue.
 
-To change the email address in your commits, see [Setting your commit email address](https://docs.github.com/en/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/setting-your-commit-email-address).
+To change the email address in your commits, see [Setting your commit email address](https://docs.github.com/en/account-and-profile/how-tos/email-preferences/setting-your-commit-email-address).
 
-To add an email address to your GitHub account, see [Adding an email address to your GitHub account](https://docs.github.com/en/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/adding-an-email-address-to-your-github-account).
+To add an email address to your GitHub account, see [Adding an email address to your GitHub account](https://docs.github.com/en/account-and-profile/how-tos/email-preferences/adding-an-email-address-to-your-github-account).
 
 
 ## Jenkins
diff --git a/docs/glossary.md b/docs/glossary.md
@@ -401,7 +401,7 @@ DPI
     Screens typically contain 72 or 96 dots per inch.
 
     ```{seealso}
-    https://developer.mozilla.org/en-US/docs/Web/CSS/resolution#dpi
+    https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Values/resolution#dpi
     ```
 
 Docker
@@ -781,7 +781,7 @@ Prettier
 
 GitHub workflow
 GitHub workflows
-    A [GitHub workflow](https://docs.github.com/en/actions/writing-workflows) is a configurable automated process that will run one or more jobs.
+    A [GitHub workflow](https://docs.github.com/en/actions/how-tos/write-workflows) is a configurable automated process that will run one or more jobs.
 
 husky
     [Husky](https://typicode.github.io/husky/) automatically lints your commit messages, code, and runs tests upon committing or pushing commits to a remote repository.
@@ -817,7 +817,7 @@ Transport Layer Security
     Transport Layer Security (TLS) is a cryptographic protocol designed to provide communications security over a computer network.
 
     ```{seealso}
-    [Transport Layer Security](https://developer.mozilla.org/en-US/docs/Web/Security/Transport_Layer_Security) article from MDN.
+    [Transport Layer Security](https://developer.mozilla.org/en-US/docs/Web/Security/Defenses/Transport_Layer_Security) article from MDN.
     ```
 
 TLS termination proxy
diff --git a/docs/i18n-l10n/index.md b/docs/i18n-l10n/index.md
@@ -33,7 +33,7 @@ Wikipedia article [Internationalization and localization](https://en.wikipedia.o
 
 Plone supports many language translations in its two frontends.
 For Volto, see [`plone/volto`](https://github.com/plone/volto/tree/main/packages/volto/locales).
-For Classic UI, see [`collective/plone.app.locales`](https://github.com/collective/plone.app.locales/tree/master/plone/app/locales/locales).
+For Classic UI, see [`collective/plone.app.locales`](https://github.com/collective/plone.app.locales/tree/master/src/plone/app/locales/locales).
 
 You can contribute new languages to both frontends.
 
diff --git a/docs/i18n-l10n/use-an-external-translation-service.md b/docs/i18n-l10n/use-an-external-translation-service.md
@@ -16,7 +16,7 @@ When translating content items in Plone, you can connect to an external translat
 
 ## Using Google Cloud Translation API
 
-The `plone.app.multilingual` product that turns Plone into a multilingual-content site supports [Google Cloud Translation API](https://cloud.google.com/translate/docs/reference/rest), which allows the content editor to use its translations.
+The `plone.app.multilingual` product that turns Plone into a multilingual-content site supports [Google Cloud Translation API](https://docs.cloud.google.com/translate/docs/reference/rest), which allows the content editor to use its translations.
 
 To use this service as a site administrator, you need to create a project in Google Cloud, enable the Cloud Translation API, and create an API key under the Credentials of the Google Cloud Console.
 You should enter this API key in the {guilabel}`Multilingual Settings` control panel in Plone.
diff --git a/submodules/plone.restapi b/submodules/plone.restapi
@@ -1 +1 @@
-Subproject commit 80a05135010269a5adbe6f0d64253de5285a4d09
+Subproject commit 392d81ff6e2adf12102036988cda776a23ef5ea9
diff --git a/submodules/volto b/submodules/volto
@@ -1 +1 @@
-Subproject commit 3974d176da4912533ef06727c70a2a5a7c4865ef
+Subproject commit f69887f4e4b414d7ac32f9a7fddb81bf196e4ac4

Original file line number	Diff line number	Diff line change
`@@ -61,7 +61,7 @@ minions = RelationList(`
`61`	`61`	`)`
`62`	`62`	```
`63`	`63`
`64`		-We can see that the [code for the behavior `IRelatedItems`](https://github.com/plone/plone.app.relationfield/blob/master/plone/app/relationfield/behavior.py) does exactly the same thing.
	`64`	+We can see that the [code for the behavior `IRelatedItems`](https://github.com/plone/plone.app.relationfield/blob/master/src/plone/app/relationfield/behavior.py) does exactly the same thing.
`65`	`65`
`66`	`66`
`67`	`67`	`(relations-controlling-relation-targets-label)=`