DOC: Add descriptions to the Pixi tasks (#2508)

Author: VeckoTheGecko

pixi.toml

@@ -63,8 +63,8 @@ pytest-html = "*"
 pytest-cov = "*"
 
 [feature.test.tasks]
-tests = "pytest"
-tests-notebooks = "pytest --nbval-lax docs/user_guide/examples"
+tests = { cmd = "pytest", description = "Run the test suite." }
+tests-notebooks = { cmd = "pytest --nbval-lax docs/user_guide/examples", description = "Run the user guide example notebooks as tests." }
 
 
 [feature.notebooks.dependencies]
@@ -87,29 +87,29 @@ sphinx-design = "*"
 sphinx-autoapi = "*"
 
 [feature.docs.tasks]
-docs = "sphinx-build docs docs/_build"
-docs-watch = 'sphinx-autobuild docs docs/_build'
-docs-linkcheck = "sphinx-build -b linkcheck docs/ docs/_build/linkcheck"
+docs = { cmd = "sphinx-build docs docs/_build", description = "Build the documentation." }
+docs-watch = { cmd = "sphinx-autobuild docs docs/_build", description = "Build and auto-rebuild the documentation on changes." }
+docs-linkcheck = { cmd = "sphinx-build -b linkcheck docs/ docs/_build/linkcheck", description = "Verify all links in documentation don't 404." }
 
 [feature.pre-commit.dependencies]
 pre_commit = "*"
 
 [feature.pre-commit.tasks]
-lint = "pre-commit run --all-files"
+lint = { cmd = "pre-commit run --all-files", description = "Run all pre-commit linting hooks." }
 
 [feature.numpydoc.dependencies]
 numpydoc = "*"
 
 [feature.numpydoc.tasks]
-numpydoc-lint = "python tools/numpydoc-public-api.py"
+numpydoc-lint = { cmd = "python tools/numpydoc-public-api.py", description = "Lint public API docstrings with numpydoc." }
 
 [feature.typing.dependencies]
 mypy = "*"
 lxml = "*" # in CI
 types-tqdm = "*"
 
 [feature.typing.tasks]
-typing = "mypy src/parcels --install-types"
+typing = { cmd = "mypy src/parcels --install-types", description = "Run static type checking with mypy." }
 
 
 [environments]