From 033e86e3d0c591b0f54314a22775d7a2e6c1d355 Mon Sep 17 00:00:00 2001
From: Roberto Polli <robipolli@gmail.com>
Date: Tue, 25 Jul 2023 16:37:26 +0200
Subject: [PATCH] Add tox documentation.

---
 .github/workflows/publish.yaml |  2 +-
 docker-101/tox.ini             |  2 +-
 git-101/Makefile               |  4 +++-
 git-101/tox.ini                | 14 +++++++++++++-
 python-basic/tox.ini           | 12 ++++++++++++
 5 files changed, 30 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/publish.yaml b/.github/workflows/publish.yaml
index 2fca8d3..ece001e 100644
--- a/.github/workflows/publish.yaml
+++ b/.github/workflows/publish.yaml
@@ -85,4 +85,4 @@ jobs:
           file: ${{ matrix.version }}.dockerfile
           push: true
           tags: ${{ steps.meta.outputs.tags }}
-          labels: ${{ steps.meta.outputs.labels }}
\ No newline at end of file
+          labels: ${{ steps.meta.outputs.labels }}
diff --git a/docker-101/tox.ini b/docker-101/tox.ini
index cee54b2..efd3230 100644
--- a/docker-101/tox.ini
+++ b/docker-101/tox.ini
@@ -8,4 +8,4 @@ deps =
 allowlist_externals =
   make
 commands =
-  make
+  make {posargs}
diff --git a/git-101/Makefile b/git-101/Makefile
index 1642cb3..64cfa07 100644
--- a/git-101/Makefile
+++ b/git-101/Makefile
@@ -6,5 +6,7 @@ all: $(BOOKS)
 	@echo $(BOOKS)
 
 notebooks/%.ipynb: %.md
-
 	notedown --to notebook $^ > $@
+
+run: all
+	jupyter notebook notebooks
diff --git a/git-101/tox.ini b/git-101/tox.ini
index cee54b2..01b4418 100644
--- a/git-101/tox.ini
+++ b/git-101/tox.ini
@@ -1,3 +1,15 @@
+#
+# This file will either build or run current notebooks
+# calling a Makefile.
+#
+# To build, run:
+#
+#    $ tox
+#
+# To run the course, run:
+#
+#    $ tox -- run
+#
 [tox]
 envlist = py3
 skipsdist = True
@@ -8,4 +20,4 @@ deps =
 allowlist_externals =
   make
 commands =
-  make
+  make {posargs}
diff --git a/python-basic/tox.ini b/python-basic/tox.ini
index efd3230..01b4418 100644
--- a/python-basic/tox.ini
+++ b/python-basic/tox.ini
@@ -1,3 +1,15 @@
+#
+# This file will either build or run current notebooks
+# calling a Makefile.
+#
+# To build, run:
+#
+#    $ tox
+#
+# To run the course, run:
+#
+#    $ tox -- run
+#
 [tox]
 envlist = py3
 skipsdist = True