feat(infra): noxfile and envt

.vscode/launch.json

@@ -0,0 +1,15 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Python Debugger: Current File",
+            "type": "debugpy",
+            "request": "launch",
+            "program": "${file}",
+            "console": "integratedTerminal"
+        }
+    ]
+}

.vscode/settings.json

@@ -0,0 +1,7 @@
+{
+    "python.terminal.executeInFileDir": true,
+    "python.terminal.launchArgs": [
+        "-m",
+        "lessons"
+    ]
+}

environment.yml

@@ -9,4 +9,5 @@ dependencies:
   - black 
   - ruff 
   - isort 
-  - jupyterlab_code_formatter
+  - jupyterlab_code_formatter
+  - jupytext

index.md

@@ -38,4 +38,12 @@ View contributors
 
 ## Who this guidebook is for
 
-This is a living guide that is updated as tools and best practices evolve in the Python packaging ecosystem. We will be adding new content over the next year.
+This living guide is updated tools and best practices evolve in the Python packaging ecosystem. We will be adding new content over the next year.
+
+:::{toctree}
+:hidden:
+:caption: Lessons
+:maxdepth: 2
+
+Lessons <clean-modular-code/intro-clean-code>
+:::

noxfile.py

@@ -99,6 +99,7 @@ def docs_live(session):
     so they don't need to remember the specific sphinx-build parameters to build a different language.
     """
     session.install("-e", ".[dev]")
+    session.install("-r", "requirements.txt")
     if not os.path.exists(OUTPUT_DIR):
         os.makedirs(OUTPUT_DIR)
     # Make sure jupy text syncs things