ci(rtd): cleanup obsolete environment and requirement files

.readthedocs.yaml

@@ -8,7 +8,6 @@ version: 2
 build:
   os: ubuntu-22.04
   tools:
-    # python: "mambaforge-22.9"
     python: "3.11"
 
 # Build documentation in the "docs/" directory with Sphinx
@@ -26,6 +25,3 @@ formats:
 python:
   install:
     - requirements: docs/requirements.txt
-
-# conda:
-#   environment: docs/environment.yml

docs/requirements.txt

@@ -1,4 +1,3 @@
-dask>=2024.4.1
 pyqt6>=6.2.2
 ipykernel
 -e '.[viz,perf,misc,docs]'

docs/source/contributing.rst

@@ -126,7 +126,7 @@ reflected in the package without having to reinstall it. Before installing:
      mamba activate <envname>
 
 
-2. Install the repository.
+2. Build and install the package.
 
    .. note::
 
@@ -138,6 +138,16 @@ reflected in the package without having to reinstall it. Before installing:
 
      pip install -e ".[dev]" --config-settings editable_mode=compat
 
+These two steps will create the new environment, and not touch any of your existing
+environments, nor any existing Python installation.
+
+To view your environments::bash
+
+    mamba env list
+
+To return to your root environment::bash
+
+    mamba deactivate
 
 Updating the editable installation
 ----------------------------------
@@ -368,12 +378,6 @@ Check whether all documentation dependencies are installed with
 
     pip install -r docs/requirements.txt
 
-or
-
-.. code-block:: sh
-
-    mamba env update -f docs/environment.yml -n <envname>
-
 then build the documentation by running:
 
 .. code-block:: sh

templates/CHANGELOG.md.j2

@@ -1,4 +1,5 @@
-# CHANGELOG
+# Changelog
+This project tries to follow [Semantic Versioning](https://semver.org/).
 {% import ".macros.j2" as macros -%}
 {% if context.history.unreleased | length > 0 %}
 {# UNRELEASED #}