enh: add upgrade guide for 020

Author: jonas-eschle

.pre-commit-config.yaml

@@ -3,7 +3,7 @@ ci:
 
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.5.0
+    rev: v4.6.0
     hooks:
       - id: check-added-large-files
       - id: check-case-conflict
@@ -35,7 +35,7 @@ repos:
 
 
   - repo: https://github.com/asottile/pyupgrade
-    rev: v3.15.0
+    rev: v3.15.2
     hooks:
       - id: pyupgrade
         args: [ --py38-plus ]
@@ -47,11 +47,10 @@ repos:
 
   # Notebook formatting
   - repo: https://github.com/nbQA-dev/nbQA
-    rev: 1.7.1
+    rev: 1.8.5
     hooks:
       - id: nbqa-isort
         additional_dependencies: [ isort==5.6.4 ]
-        args: [ --nbqa-mutate ]
 
       - id: nbqa-pyupgrade
         additional_dependencies: [ pyupgrade==2.7.4 ]
@@ -67,22 +66,21 @@ repos:
     rev: 'v1.0'
     hooks:
       - id: upgrade-type-hints
-        args: [ '--futures=true' ]
 
   - repo: https://github.com/psf/black
-    rev: 23.12.1
+    rev: 24.4.0
     hooks:
       - id: black
         language: python
 
 
   - repo: https://github.com/janosh/format-ipy-cells
-    rev: v0.1.10
+    rev: v0.1.11
     hooks:
       - id: format-ipy-cells
 
   - repo: https://github.com/kynan/nbstripout
-    rev: 0.6.1
+    rev: 0.7.1
     hooks:
       - id: nbstripout
 

_website/tutorials/introduction/README.rst

@@ -25,3 +25,13 @@ that explain the elementary aspects of zfit.
 
     Introduction.ipynb
     Introduction_long.ipynb
+
+What's new
++++++++++++
+
+To know about the newest features in version 0.20+, see the changelog and the guide.
+
+.. toctree::
+    :maxdepth: 2
+
+    upgrade_guide_020.ipynb

introduction/README.rst

@@ -25,3 +25,13 @@ that explain the elementary aspects of zfit.
 
     Introduction.ipynb
     Introduction_long.ipynb
+
+What's new
++++++++++++
+
+To know about the newest features in version 0.20+, see the changelog and the guide.
+
+.. toctree::
+    :maxdepth: 2
+
+    upgrade_guide_020.ipynb