Clean up install with Cookieplone (#1929)

* Clean up install with Cookieplone
- Rewrite introduction where Cookieplone is a tool, not a template
- Move hardware to first subsection of requirements
- Remove Python as a prerequisite, now that uv handles it
- Move enumerated item 3 from pages into the Volto include for installing Node.js
- Add a cross-reference to activation of LTS version of Node.js
- Create a make command to toggle the symlink between Volto and Seven
- Restore mistakenly removed include for Python and Plone 6.1

* Move `_inc/_install-uv.md` from `plone/documentation` to `plone/volto` and refactor

* Fix cross-references

* - Move hardware requirements from main documentation to volto

Author: stevepiercy

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

@@ -0,0 +1,9 @@
+Installing Python is beyond the scope of this documentation.
+However, it is recommended to use a Python version manager, {term}`pyenv`, that allows you to install multiple versions of Python on your development environment without destroying your system's Python.
+
+```{warning}
+Do not create or activate a Python virtual environment at this time.
+The instructions below will create one.
+```
+
+Plone 6.1 requires Python version {{SUPPORTED_PYTHON_VERSIONS_PLONE61}}.

docs/_inc/_install-python-plone61.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-uv.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

@@ -12,41 +12,40 @@ myst:
 
 # Install Plone with Cookieplone
 
-This chapter describes how you can create a web application using the {term}`Cookieplone` template.
-
-This template is the recommended way to start a new Plone project using the Volto frontend.
+This chapter describes how you can create a web application using {term}`Cookieplone`.
+Cookieplone is the recommended way to create a Plone project as an add-on using the Volto frontend.
 It also includes tools for development and deployment.
 
 ```{seealso}
 For other installation options, see {ref}`get-started-install-label`.
 ```
 
 ```{versionadded} Volto 18.0.0-alpha.43
-{term}`Cookieplone` was added as the recommended template to create a Plone project with Volto starting in Volto 18.0.0-alpha.43 and above.
+{term}`Cookieplone` was added as the recommended tool to create a Plone project with Volto starting in Volto 18.0.0-alpha.43 and above.
 ```
 
 
 (create-project-cookieplone-system-requirements)=
 
 ## System requirements
 
-Plone 6 has both hardware requirements and software prerequisites.
+Plone has both hardware requirements and software prerequisites.
 
 
-### Supported web browsers
+(create-project-cookieplone-hardware-requirements-label)=
 
-```{include} /volto/_inc/_install-browser-reqs-volto.md
-```
+### Hardware requirements
 
-```{include} /_inc/_install-browser-reqs-classic-ui.md
+```{include} /volto/_inc/_hardware-requirements.md
 ```
 
 
-(create-project-cookieplone-hardware-requirements-label)=
+### Supported web browsers
 
-### Hardware requirements
+```{include} /volto/_inc/_install-browser-reqs-volto.md
+```
 
-```{include} /_inc/_hardware-requirements.md
+```{include} /_inc/_install-browser-reqs-classic-ui.md
 ```
 
 
@@ -66,32 +65,23 @@ Plone 6 has both hardware requirements and software prerequisites.
 
 #### uv
 
-```{include} /_inc/_install-uv.md
+```{include} ../volto/_inc/_install-uv.md
 ```
 
 
-#### Python
-
-{term}`uv` will download and install the required Python version for your project.
-
-
 #### nvm
 
 ```{include} ../volto/_inc/_install-nvm.md
 ```
 
 
+(prerequisites-for-installation-nodejs-label)=
+
 #### Node.js
 
 ```{include} ../volto/_inc/_install-nodejs.md
 ```
 
-3.  Enable {term}`corepack` so that Node.js will install {term}`pnpm` as a package manager.
-
-    ```shell
-    npm i -g corepack@latest && corepack enable
-    ```
-
 
 #### Make
 
@@ -109,8 +99,7 @@ Plone 6 has both hardware requirements and software prerequisites.
 
 ## Generate the project
 
-After satisfying the prerequisites and having activated an LTS version of Node,
-generate the project.
+After satisfying the prerequisites and having {ref}`activated an LTS version of Node.js <prerequisites-for-installation-nodejs-label>`, generate the project.
 
 ```shell
 uvx cookieplone project