Update admin-guide/add-ons.md

Author: davisagli

docs/admin-guide/add-ons.md

@@ -18,13 +18,17 @@ The Volto frontend has its own system of add-ons using Node.js packages.
 See {doc}`/volto/development/add-ons/index`.
 ```
 
+## Install an add-on from PyPI
 
-## Cookieplone
+For instructions to install an add-on that is released on {term}`PyPI`, select the tab below according to your Python package manager.
 
-Use the following instructions if you installed Plone with Cookieplone.
+```{tip}
+Select the tab for uv if you have a project that was created using Cookieplone.
+```
 
+`````{tab-set}
 
-### Install an add-on
+````{tab-item} uv
 
 Add the name of your add-on in the file {file}`backend/pyproject.toml` in the section `dependencies`.
 This example adds [`collective.easyform`](https://pypi.org/project/collective.easyform/).
@@ -59,127 +63,106 @@ To actually download and install the new add-on, run the following command.
 make backend-build
 ```
 
-Now restart the backend.
-
-```{seealso}
-{doc}`run-plone`
-```
-
-In your web browser, and assuming you are currently logged in as an administrator, visit the URL http://localhost:8080/Plone/prefs_install_products_form.
-
-Then click the {guilabel}`Install` button next to your add-on to complete installation of the add-on.
-
-Some add-ons have configuration options.
-To configure such add-ons, return to the {guilabel}`Site Setup` control panel.
-At the bottom of the page, you should see the heading {guilabel}`Add-on Configuration`, and a control panel to configure the add-on that you just installed.
+````
 
+````{tab-item} Buildout
 
-### Install an add-on from source
-
-An add-on can be installed from a source control system such as GitHub.
-
-Add a line with the name of your add-on in the file {file}`backend/requirements.txt`.
+Update the file {file}`buildout.cfg`.
 This example uses [`collective.easyform`](https://pypi.org/project/collective.easyform/).
 
-```
-collective.easyform
-```
-
-```{note}
-When installing an add-on from source, it's best not to pin a version.
-This way you always get the version that's currently available in the source control system.
-```
-
-Next add the add-on to `zcml_package_includes` in the file {file}`backend/instance.yaml` so that its configuration will load.
+```cfg
+[buildout]
+extends =
+    https://dist.plone.org/release/6-latest/versions.cfg
 
-```yaml
-default_context:
-    zcml_package_includes: project_title, collective.easyform
-```
+parts =
+    instance
 
-Finally, add the package's source to the file {file}`mx.ini`.
+[instance]
+recipe = plone.recipe.zope2instance
+user = admin:admin
+http-address = 8080
+eggs =
+    Plone
+    collective.easyform
 
-```cfg
-[collective.easyform]
-url=git@github.com:collective/collective.easyform.git
-branch=dev-branch-name
-extras=test
+[versions]
+collective.easyform = 4.2.1
 ```
 
-```{seealso}
-The {file}`mx.ini` file configures a tool called {term}`mxdev`.
-See the [documentation of `mxdev` in its README.md](https://github.com/mxstack/mxdev/blob/main/README.md) for complete information.
+```{tip}
+Including the add-on version, or "pinning a version", ensures that it won't unintentionally get upgraded in the future.
 ```
 
-Stop the backend with {kbd}`ctrl-c`.
-
 To actually download and install the new add-on, run the following command.
 
 ```shell
-make backend-build
+bin/buildout -N
 ```
 
+````
+
+`````
+
 Now restart the backend.
 
 ```{seealso}
 {doc}`run-plone`
 ```
 
 In your web browser, and assuming you are currently logged in as an administrator, visit the URL http://localhost:8080/Plone/prefs_install_products_form.
-An upgrade step might need to be performed in the Plone control panel.
-Follow the upgrade information, if present.
-Else click the {guilabel}`Install` button to complete installation of the add-on.
 
+Then click the {guilabel}`Install` button next to your add-on to complete installation of the add-on.
+
+Some add-ons have configuration options.
+To configure such add-ons, return to the {guilabel}`Site Setup` control panel.
+At the bottom of the page, you should see the heading {guilabel}`Add-on Configuration`, and a control panel to configure the add-on that you just installed.
 
-## Buildout
 
-Use the following instructions if you installed Plone with Buildout.
+## Install an add-on from source
 
-### Install an add-on
+An unreleased add-on can be installed from a source control system such as GitHub.
 
-Update the file {file}`buildout.cfg`.
-This example uses [`collective.easyform`](https://pypi.org/project/collective.easyform/).
+For instructions to install an add-on that is released on {term}`PyPI`, select the tab below according to your Python package manager.
 
-```cfg
-[buildout]
-extends =
-    https://dist.plone.org/release/6-latest/versions.cfg
+```{tip}
+Select the tab for uv if you have a project that was created using Cookieplone.
+```
 
-parts =
-    instance
+`````{tab-set}
 
-[instance]
-recipe = plone.recipe.zope2instance
-user = admin:admin
-http-address = 8080
-eggs =
-    Plone
-    collective.easyform
+````{tab-item} uv
 
-[versions]
-collective.easyform = 4.2.1
-```
+Clone the repository into a local directory.
+This example uses [`collective.easyform`](https://pypi.org/project/collective.easyform/).
 
-```{tip}
-Including the add-on version, or "pinning a version", ensures that it won't unintentionally get upgraded in the future.
+```shell
+git clone git@github.com:collective/collective.easyform.git
 ```
 
-To actually download and install the new add-on, run the following command.
+Add the local directory to your uv project as an editable package.
 
 ```shell
-bin/buildout
+cd backend
+uv add --editable ../collective.easyform
 ```
 
-Then restart your instance.
-
-```{seealso}
-{doc}`run-plone`
+```{note}
+When installing an add-on from source, it's best not to pin a version.
+This way you always get the version that's currently available in the source control system.
 ```
 
+Next add the add-on to `zcml_package_includes` in the file {file}`backend/instance.yaml` so that its configuration will load.
 
-### Install an add-on from source
+```yaml
+default_context:
+    zcml_package_includes: project_title, collective.easyform
+```
+
+Stop the backend with {kbd}`ctrl-c`.
+````
 
-You can install an add-on from a source control system such as GitHub.
+````{tab-item} Buildout
 
 Update the file {file}`buildout.cfg`.
 This example uses [`collective.easyform`](https://pypi.org/project/collective.easyform/).
@@ -213,12 +196,24 @@ To actually download and install the new add-on, run the following command.
 bin/buildout
 ```
 
-Then restart your instance.
-
 ```{seealso}
-{doc}`run-plone`
+This approach uses the [`mr.developer`](https://pypi.org/project/mr.developer/) Buildout extension.
 ```
 
+````
+
+`````
+
+Now restart the backend.
+
 ```{seealso}
-This approach uses the [`mr.developer`](https://pypi.org/project/mr.developer/) Buildout extension.
+{doc}`run-plone`
 ```
+
+In your web browser, and assuming you are currently logged in as an administrator, visit the URL http://localhost:8080/Plone/prefs_install_products_form.
+
+Then click the {guilabel}`Install` button next to your add-on to complete installation of the add-on.
+
+Some add-ons have configuration options.
+To configure such add-ons, return to the {guilabel}`Site Setup` control panel.
+At the bottom of the page, you should see the heading {guilabel}`Add-on Configuration`, and a control panel to configure the add-on that you just installed.

docs/glossary.md

@@ -104,6 +104,9 @@ pyenv
     Python version management.
     [pyenv](https://github.com/pyenv/pyenv) lets you easily switch between multiple versions of Python.
 
+PyPI
+    The [Python Package Index](https://pypi.org/) is a repository of software for the Python programming language.
+
 uv
     [uv](https://docs.astral.sh/uv/) is a Python package and project manager, written in Rust.