Apply suggestions from code review

jklymak · timhoffm · web-flow · commit a40ae3f3db3e · 2026-04-01T07:22:57.000-07:00
Co-authored-by: Tim Hoffmann &lt;2836374+timhoffm@users.noreply.github.com&gt;
diff --git a/doc/devel/development_setup.rst b/doc/devel/development_setup.rst
@@ -218,15 +218,18 @@ setup.
 
          pixi run python -c "import matplotlib; print(matplotlib.__file__)"
 
-      Note there are some pixi tasks available as shortcuts::
+      .. note::
+         We provide some pixi tasks as shortcuts for common developent tasks. List the
+         available tasks via ::
 
-         pixi task list
+            pixi task list
 
-      If you do not want to use ``pixi run`` in front of every command, you can do::
+      .. tip::
+         If you do not want to use ``pixi run`` in front of every command, you can do::
 
-         pixi shell
+            pixi shell
 
-      and continue to use pixi as a python environment.
+         and continue to use pixi as a python environment.
 
       .. note:: do not edit the ``pyproject.toml`` file and commit to the repository, as this
          will affect all developers.  If you want to change the dependencies, please open an
