Merge branch '6.0' into rohnsha0-control-panel

Author: rohnsha0

Makefile

@@ -73,6 +73,18 @@ docs/volto:  ## Setup Volto docs
 	@echo "Documentation of volto initialized."
 	@echo
 
+ln-seven:  ## Toggle the symlink to Seven
+	rm docs/volto
+	ln -s ../submodules/volto/docs ./docs/volto
+	@echo "Symlink to Volto changed to Seven."
+	@echo
+
+ln-volto:  ## Toggle the symlink to Volto
+	rm docs/volto
+	ln -s ../submodules/volto/docs/source ./docs/volto
+	@echo "Symlink to Seven changed to Volto."
+	@echo
+
 .PHONY: deps
 deps: venv/bin/python docs/volto docs/plone.restapi venv/plone.api-install  ## Create Python virtual environment, install requirements, initialize or update the volto, plone.restapi, and plone.api submodules, create symlinks to the source files, and finally install plone.api.
 

docs/_inc/_hardware-requirements.md

@@ -60,7 +60,7 @@ Here, the event handler code will only be executed if the object is a content ty
 If you want this to be interface agnostic, insert an asterix `*` as a wildcard instead.
 
 The third line defines the event on which this should happen, which is `IObjectCreatedEvent`. 
-For more available possible events to use as a trigger, see {ref}`subscribers-event-handlers`. 
+For more available possible events to use as a trigger, see {ref}`subscribers-event-types-label`. 
 
 The fourth line gives the path to the callable function to be executed.
 

docs/_inc/_install-pipx.md

@@ -371,7 +371,7 @@ The Plone Documentation Team adopted additional guidelines.
     To make that work in Volto, set your browser width to 1180 pixels.
     You will notice that the drag and trash icons for each block move inside the block from outside.
 
-    If you create images wider than 740 pixels, then you must use image display enhancement as described in {ref}`enhance-images-label`.
+    If you create images wider than 740 pixels, then you must use image display enhancement as described in {ref}`enhance-media-label`.
 -   In user documentation, provide screenshots of each step where the interface changes.
     It is painstaking, but worth the effort.
     Provide sufficient detail of what each option is and does.

docs/backend/subscribers.md

@@ -22,7 +22,7 @@ MyST extends {term}`Markdown` by incorporating all the features of {term}`reStru
 Contributors are welcome to use either Markdown or MyST syntax.
 
 MyST may be more familiar to reStructuredText authors.
-MyST allows the use of a {term}`fence` and `{rst-eval}` to evaluate native reStructuredText.
+MyST allows the use of a {term}`fence` and `{eval-rst}` to evaluate native reStructuredText.
 This may be useful when Markdown does not provide sufficient flexibility, such as for `figure`.
 
 

docs/contributing/documentation/authors.md

@@ -20,6 +20,7 @@ To contribute to any project in Plone, you must follow the policies of the [Plon
 This chapter covers policies that apply to all Plone projects.
 Other chapters cover any variations and additional policies for each project.
 
+
 (contributing-sign-and-return-the-plone-contributor-agreement-label)=
 
 ## Sign and return the Plone Contributor Agreement
@@ -77,6 +78,7 @@ Someone will help identify in which of the dozens of repositories that make up P
 ```{include} /_inc/_continuous-integration.md
 ```
 
+
 (contributing-change-log-label)=
 
 ## Change log entry
@@ -102,11 +104,11 @@ When making a change to its documentation, set up, continuous integration, or ot
 
 The change log entry's format must be `###.type`, where `###` is the referenced GitHub issue or pull request number, `.` is the literal extension delimiter, and `type` is one of the following strings.
 
-- `breaking` for breaking changes
-- `bugfix` for bug fixes
-- `documentation` for documentation
-- `feature` for new features
-- `internal` for internal changes
+-   `breaking` for breaking changes
+-   `bugfix` for bug fixes
+-   `documentation` for documentation
+-   `feature` for new features
+-   `internal` for internal changes
 
 A package configures the types it allows in a file `towncrier.toml` located at the root of its package directory.
 
@@ -156,6 +158,25 @@ To standarize the developer experience across packages, a configuration tool is
 
 See the [tool documentation](https://github.com/plone/meta) for more information.
 
+
+(contributing-guidance-for-merging-pull-requests-label)=
+
+## Guidance for merging pull requests
+
+-   If you have any doubt, don't merge, but ask.
+-   All {doc}`CI checks <core/continuous-integration>` must pass, unless there is a good reason to ignore it.
+    If you ignore a check, then write the good reason either in a comment or in the merge message.
+-   Get at least one approval from another Plone contributor, preferably a member of the GitHub Team for the repository.
+-   If the pull request has documentation, ask for a review from `@plone/documentation-team`.
+-   Usually the merge message populates with all the commit messages, but some repositories aren't configured to do this.
+    It's helpful to include a descriptive message in the merge request.    
+-   After merging, look for any linked issues that should be closed, and close them.
+    Sometimes the contributor forgets to include `closes #123` in the description, which would automatically close the related issue.
+-   If the change is a bugfix, make sure that it is not merged to an older release branch unless it is also merged in separate pull request to `main`.
+-   Thank the contributor.
+-   🍻
+
+
 (contributing-specific-contribution-policies-for-projects-label)=
 
 ## Specific contribution policies of projects

docs/contributing/documentation/myst-reference.md

@@ -99,6 +99,13 @@ pyenv
     Python version management.
     [pyenv](https://github.com/pyenv/pyenv) lets you easily switch between multiple versions of Python.
 
+uv
+    [uv](https://docs.astral.sh/uv/) is a Python package and project manager, written in Rust.
+
+`uvx`
+    `uvx` is an alias for `uv tool run`, implemented in {term}`uv`.
+     It executes and installs command-line tools provided by Python packages in an ephemeral environment, similar to {term}`pipx`.
+
 pm2
     [PM2](https://pm2.keymetrics.io/) is a daemon process manager.
 
@@ -463,7 +470,7 @@ Slate
     `volto-slate` is an interactive default text editor for Volto, developed on top of {term}`Slate`, offering enhanced {term}`WYSIWYG` functionality and behavior.
 
 WYSIWYG
-    WYSIWYG is an acronym for "what you see is what you get", referring to software that allows content to be edited in a form that resembles its appearance when printed or displayed as a finished product.    
+    WYSIWYG is an acronym for "what you see is what you get", referring to software that allows content to be edited in a form that resembles its appearance when printed or displayed as a finished product.
 
 TinyMCE
     The rich text {term}`WYSIWYG` editor used in {term}`Classic UI`.
@@ -563,7 +570,7 @@ ZODB
     [A native object database for Python](https://zodb.org/en/latest/).
 
 `FileStorage`
-    `FileStorage` is a Python class in {term}`ZODB` that saves data in a file.    
+    `FileStorage` is a Python class in {term}`ZODB` that saves data in a file.
 
     ```{seealso}
     https://zodb.org/en/latest/reference/storages.html#filestorage
@@ -868,7 +875,7 @@ schema enhancer
 variation
     A variation is a common development pattern that provides alternative views for the same data.
     For example, a teaser block can present data as `title + link`, `title + description + link`, or `title + image + link`.
-        
+
     An advanced variation can enhance the block by adding data fields to the block.
     For example, a listing block variation can show news items with `title + link`.
     Extending this example, a developer can add a boolean field to the block that toggles the display of the link.
@@ -880,7 +887,7 @@ Higher-Order Component
     HOCs are not part of the React API, per se.
     They are a pattern that emerges from React's compositional nature.
     Concretely, a higher-order component is a function that takes a component and returns a new component.
-    
+
     ```{important}
     Higher-order components are not commonly used in modern React code.
     ```

docs/contributing/index.md

@@ -28,10 +28,9 @@ You will need to work in one repository for Plone core, and optionally another o
 ## Prerequisites
 
 Request write access to https://github.com/collective/plone.app.locales to be able to commit your translation directly.
-
 To do so, [join the collective GitHub organization](https://collective.github.io/).
 
-Optionally sign the [Plone Contributor Agreement](https://plone.org/foundation/contributors-agreement) for translating Volto.
+Because translation strings do not constitute an original "work", translators are not required to sign the [Plone Contributor Agreement (PCA)](https://plone.org/foundation/contributors-agreement) to contribute translations to either Plone or Volto.
 
 
 (contributing-plone-core-translations-translate-plone-classic-ui-label)=
@@ -75,10 +74,7 @@ The process of translating the Volto frontend is the following.
     -  To update a translation, translate your language's `po` file found at `locales/{language_code}/LC_MESSAGES/volto.po`.
     -  To create a new translation, create a new directory at `locales/{language_code}/LC_MESSAGES/`, copy the file `locales/volto.pot` to `locales/{language_code}/LC_MESSAGES/volto.po` (note to drop the trailing `t`), and start translating.
 
-4. Run `make i18n` to convert your `po` files into `json`.
-   Volto loads these `json` files to provide translated text strings in the interface.
-
-5. Commit your changes, and create a pull request.
+4.  Commit your changes, and create a pull request.
 
 ```{seealso}
 {doc}`Volto frontend development internationalization </volto/development/i18n>`
@@ -98,17 +94,13 @@ Plone gets free hosting at the [Hosted](https://hosted.weblate.org/) platform th
 
 Translators will need to create an account on Weblate with an email and password.
 Authentication with GitHub and other third-party accounts might not work.
+You can [configure your Weblate account to receive notifications](https://hosted.weblate.org/accounts/profile/#notifications) either automatically whenever you make a contribution to a project or manually watch specific projects.
 
 Translators can go to the [Plone project in Weblate](https://hosted.weblate.org/projects/plone/).
 
 You will see several components listed.
 The `volto` component is for the package `volto`, whose repository is at https://github.com/plone/volto.
 
-```{note}
-At this moment Volto translations can't be contributed using Weblate.
-The Volto Team are working on this issue, and hope to fix it as soon as possible.
-```
-
 All other components are for the package `plone.app.locales`, whose repository is at https://github.com/collective/plone.app.locales.
 
 See the Weblate documentation, [Translating using Weblate](https://docs.weblate.org/en/latest/user/translating.html), for how to use it to write translations.
@@ -117,7 +109,7 @@ When you save a translation, then it is committed on a branch used only for tran
 
 [See recent commits to the package `plone.app.locales`](https://github.com/collective/plone.app.locales/commits/master/).
 
-Maintainers will periodically create a pull request from the changes, and merge it.
+Maintainers will periodically review the pull request that Weblate creates automatically, and merge it.
 
 
 (contributing-plone-core-translations-support-label)=