doc: enable strict docs creation

.pre-commit-config.yaml

@@ -25,12 +25,12 @@ repos:
     -   id: python-no-log-warn
     -   id: text-unicode-replacement-char
 -   repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.15.12
+    rev: v0.15.13
     hooks:
       - id: ruff-format
       - id: ruff-check
 -   repo: https://github.com/astral-sh/uv-pre-commit
-    rev: 0.11.13
+    rev: 0.11.14
     hooks:
       - id: uv-lock
 -   repo: local
@@ -60,14 +60,14 @@ repos:
             mdformat-pyproject>=0.0.2,
         ]
         files: (docs/.)
-        exclude: (docs/source/reference_guides/hookspecs\.md|docs/source/reference_guides/api/.*\.md|docs/source/how_to_guides/capture_warnings\.md|docs/source/how_to_guides/hashing_inputs_of_tasks\.md|docs/source/how_to_guides/provisional_nodes_and_task_generators\.md|docs/source/how_to_guides/remote_files\.md|docs/source/how_to_guides/writing_custom_nodes\.md|docs/source/tutorials/defining_dependencies_products\.md|docs/source/tutorials/using_a_data_catalog\.md)
+        exclude: (docs/source/reference_guides/hookspecs\.md|docs/source/reference_guides/api/.*\.md|docs/source/how_to_guides/capture_warnings\.md|docs/source/how_to_guides/hashing_inputs_of_tasks\.md|docs/source/how_to_guides/provisional_nodes_and_task_generators\.md|docs/source/how_to_guides/remote_files\.md|docs/source/how_to_guides/writing_custom_nodes\.md|docs/source/tutorials/defining_dependencies_products\.md|docs/source/tutorials/using_a_data_catalog\.md|docs/source/tutorials/write_a_task\.md|docs/source/tutorials/visualizing_the_dag\.md|docs/source/how_to_guides/bp_complex_task_repetitions\.md|docs/source/tutorials/repeating_tasks_with_different_inputs\.md)
 -   repo: https://github.com/kynan/nbstripout
     rev: 0.9.1
     hooks:
     -   id: nbstripout
         exclude: (docs)
 -   repo: https://github.com/crate-ci/typos
-    rev: v1
+    rev: v1.46.1
     hooks:
     -   id: typos
         exclude: (\.ipynb)

README.md

@@ -21,29 +21,23 @@ ______________________________________________________________________
 
 <!-- Keep in sync with docs/source/index.md -->
 
-pytask is a workflow management system that facilitates reproducible data analyses. Its
-features include:
+pytask facilitates reproducible data analyses. Its features are:
 
-- **Automatic discovery of tasks.**
-- **Lazy evaluation.** If a task, its dependencies, and its products have not changed,
-  do not execute it.
-- **Debug mode.**
+- **Automatic discovery of tasks**
+- **Lazy execution**: Skip tasks when inputs and outputs are unchanged.
+- **Debug mode**:
   [Jump into the debugger](https://pytask-dev.readthedocs.io/en/stable/tutorials/debugging.html)
-  if a task fails, get feedback quickly, and be more productive.
-- **Repeat a task with different inputs.**
-  [Loop over task functions](https://pytask-dev.readthedocs.io/en/stable/tutorials/repeating_tasks_with_different_inputs.html)
-  to run the same task with different inputs.
-- **Select tasks via expressions.** Run only a subset of tasks with
-  [expressions and marker expressions](https://pytask-dev.readthedocs.io/en/stable/tutorials/selecting_tasks.html).
-- **Easily extensible with plugins**. pytask is built on
-  [pluggy](https://pluggy.readthedocs.io/en/latest/), a plugin management framework that
-  allows you to adjust pytask to your needs. Plugins are available for
+  if a task fails.
+- **Repeat a task with different inputs**:
+  [Loop over task functions](https://pytask-dev.readthedocs.io/en/stable/tutorials/repeating_tasks_with_different_inputs.html).
+- **Task Selection**: Run subsets with
+  [expressions and markers](https://pytask-dev.readthedocs.io/en/stable/tutorials/selecting_tasks.html).
+- **Plugins**: Extend pytask with plugins for
   [parallelization](https://github.com/pytask-dev/pytask-parallel),
   [LaTeX](https://github.com/pytask-dev/pytask-latex),
   [R](https://github.com/pytask-dev/pytask-r), and
-  [Stata](https://github.com/pytask-dev/pytask-stata) and more can be found
-  [here](https://github.com/topics/pytask). Learn more about plugins in
-  [this tutorial](https://pytask-dev.readthedocs.io/en/stable/tutorials/plugins.html).
+  [Stata](https://github.com/pytask-dev/pytask-stata), and
+  [more](https://pytask-dev.readthedocs.io/en/stable/tutorials/plugins.html).
 
 # Installation