From eec3210859026eba62a0cd7a4372066378eb2d65 Mon Sep 17 00:00:00 2001
From: Jace Browning <jacebrowning@gmail.com>
Date: Thu, 28 Jul 2022 17:08:54 -0400
Subject: [PATCH] Upgrade mkdocs to 1.3

---
 datafiles/manager.py               |  2 +-
 docs/requirements.txt              |  2 +-
 notebooks/file_inference.ipynb     | 22 ++++++++--------
 notebooks/format_options.ipynb     | 26 +++++++++----------
 notebooks/generic_types.ipynb      | 16 ++++++------
 notebooks/manager_api.ipynb        | 28 ++++++++++-----------
 notebooks/mapper_api.ipynb         | 40 +++++++++++++++---------------
 notebooks/nested_dataclass.ipynb   | 24 +++++++++---------
 notebooks/patched_containers.ipynb | 36 +++++++++++++--------------
 notebooks/readme.ipynb             | 37 ++++++++++++++++-----------
 notebooks/roundtrip_comments.ipynb | 28 ++++++++++-----------
 poetry.lock                        | 38 ++++++++++------------------
 pyproject.toml                     |  2 +-
 13 files changed, 148 insertions(+), 153 deletions(-)

diff --git a/datafiles/manager.py b/datafiles/manager.py
index d8eab936..0e898162 100644
--- a/datafiles/manager.py
+++ b/datafiles/manager.py
@@ -68,7 +68,7 @@ def all(self, *, _exclude: str = "") -> Iterator[Model]:
         else:
             try:
                 root = Path(inspect.getfile(self.model)).parent
-            except TypeError:
+            except (TypeError, OSError):
                 level = log.DEBUG if "__main__" in str(self.model) else log.WARNING
                 log.log(level, f"Unable to determine module for {self.model}")
                 root = Path.cwd()
diff --git a/docs/requirements.txt b/docs/requirements.txt
index b3e0b16a..58a2af4f 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,5 +1,5 @@
 jinja2==3.0.3; python_version >= "3.6"
 markdown==3.3.4; python_version >= "3.6"
-mkdocs==1.2.3; python_version >= "3.6"
+mkdocs==1.3.1; python_version >= "3.6"
 jupyterlab-pygments==0.1.2; python_version >= "3.6"
 pygments==2.10.0; python_version >= "3.5"
diff --git a/notebooks/file_inference.ipynb b/notebooks/file_inference.ipynb
index 109491ca..efe84d83 100644
--- a/notebooks/file_inference.ipynb
+++ b/notebooks/file_inference.ipynb
@@ -2,7 +2,7 @@
  "cells": [
   {
    "cell_type": "markdown",
-   "id": "11f00e16",
+   "id": "663a2d5f",
    "metadata": {
     "tags": []
    },
@@ -13,7 +13,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "efa99e38",
+   "id": "f0fef488",
    "metadata": {
     "tags": []
    },
@@ -40,7 +40,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "b0fdffcf",
+   "id": "b97c05fa",
    "metadata": {
     "tags": []
    },
@@ -67,7 +67,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "d45b3d6c",
+   "id": "d083fdda",
    "metadata": {
     "tags": []
    },
@@ -79,7 +79,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "279a6cce",
+   "id": "51888e49",
    "metadata": {
     "tags": []
    },
@@ -106,7 +106,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "72468375",
+   "id": "7e8d711b",
    "metadata": {
     "tags": []
    },
@@ -117,7 +117,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "804fcad9",
+   "id": "ebb10f13",
    "metadata": {
     "tags": []
    },
@@ -176,7 +176,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "8102429a",
+   "id": "e3bea710",
    "metadata": {
     "tags": []
    },
@@ -190,7 +190,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "f7ca3f5f",
+   "id": "f7ece25f",
    "metadata": {
     "tags": []
    },
@@ -202,7 +202,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "6e28c527",
+   "id": "3b2ca577",
    "metadata": {
     "tags": []
    },
@@ -267,7 +267,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.9.7"
+   "version": "3.10.0"
   }
  },
  "nbformat": 4,
diff --git a/notebooks/format_options.ipynb b/notebooks/format_options.ipynb
index 5c8ec14c..cf3ba06c 100644
--- a/notebooks/format_options.ipynb
+++ b/notebooks/format_options.ipynb
@@ -3,7 +3,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "067e3e1d",
+   "id": "0263aa10",
    "metadata": {
     "tags": []
    },
@@ -17,7 +17,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "8de91f4e",
+   "id": "ab87782e",
    "metadata": {
     "tags": []
    },
@@ -42,7 +42,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "ef078549",
+   "id": "e47c2409",
    "metadata": {
     "tags": []
    },
@@ -53,7 +53,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "28b77ef7",
+   "id": "27ea442a",
    "metadata": {
     "tags": []
    },
@@ -71,7 +71,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "0e28d134",
+   "id": "38887441",
    "metadata": {
     "tags": []
    },
@@ -108,7 +108,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "ca094d1b",
+   "id": "dc40b2c9",
    "metadata": {
     "tags": []
    },
@@ -119,7 +119,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "7a992941",
+   "id": "768ce8c2",
    "metadata": {
     "tags": []
    },
@@ -137,7 +137,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "450147f0",
+   "id": "cb0bf220",
    "metadata": {
     "tags": []
    },
@@ -169,7 +169,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "b1d1b85a",
+   "id": "954e19b5",
    "metadata": {
     "tags": []
    },
@@ -180,7 +180,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "3c7b6aec",
+   "id": "cbabf428",
    "metadata": {
     "tags": []
    },
@@ -198,7 +198,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "39fb7d63",
+   "id": "a7d6e4f4",
    "metadata": {
     "tags": []
    },
@@ -228,7 +228,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "0491afdf",
+   "id": "ceb45a38",
    "metadata": {
     "tags": []
    },
@@ -252,7 +252,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.9.7"
+   "version": "3.10.0"
   }
  },
  "nbformat": 4,
diff --git a/notebooks/generic_types.ipynb b/notebooks/generic_types.ipynb
index 2fa5076e..1a736540 100644
--- a/notebooks/generic_types.ipynb
+++ b/notebooks/generic_types.ipynb
@@ -2,7 +2,7 @@
  "cells": [
   {
    "cell_type": "markdown",
-   "id": "3ede8382",
+   "id": "0f78f39a",
    "metadata": {
     "tags": []
    },
@@ -13,7 +13,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "839257de",
+   "id": "f1b4bf74",
    "metadata": {
     "tags": []
    },
@@ -27,7 +27,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "9c93ac53",
+   "id": "821ed3f1",
    "metadata": {
     "tags": []
    },
@@ -73,7 +73,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "7acf6c6a",
+   "id": "e294ab15",
    "metadata": {
     "tags": []
    },
@@ -84,7 +84,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "960f7ef6",
+   "id": "3f72c876",
    "metadata": {
     "tags": []
    },
@@ -92,7 +92,7 @@
     {
      "data": {
       "text/plain": [
-       "Dictish(contents=[<__main__.Pair object at 0x1086b5af0>, <__main__.Pair object at 0x1086b5be0>])"
+       "Dictish(contents=[<__main__.Pair object at 0x1099cefb0>, <__main__.Pair object at 0x1099cef50>])"
       ]
      },
      "execution_count": null,
@@ -107,7 +107,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "04712b7e",
+   "id": "a629e314",
    "metadata": {
     "tags": []
    },
@@ -147,7 +147,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.9.7"
+   "version": "3.10.0"
   }
  },
  "nbformat": 4,
diff --git a/notebooks/manager_api.ipynb b/notebooks/manager_api.ipynb
index ea691ebe..8b5c561d 100644
--- a/notebooks/manager_api.ipynb
+++ b/notebooks/manager_api.ipynb
@@ -3,7 +3,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "89b84447",
+   "id": "b8bcf53e",
    "metadata": {
     "tags": []
    },
@@ -17,7 +17,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "cfe8e03d",
+   "id": "356432ac",
    "metadata": {
     "tags": []
    },
@@ -35,7 +35,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "139a7c33",
+   "id": "1bb4584c",
    "metadata": {
     "tags": []
    },
@@ -57,7 +57,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "e17526a8",
+   "id": "7ec4794d",
    "metadata": {
     "tags": []
    },
@@ -68,7 +68,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "37d1d398",
+   "id": "68a3211d",
    "metadata": {
     "tags": []
    },
@@ -91,7 +91,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "43b215fc",
+   "id": "c1bc8feb",
    "metadata": {
     "tags": []
    },
@@ -104,7 +104,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "5b6cab43",
+   "id": "4c8a588d",
    "metadata": {
     "tags": []
    },
@@ -115,7 +115,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "c537616b",
+   "id": "fcb345c6",
    "metadata": {
     "tags": []
    },
@@ -138,7 +138,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "43e57ad0",
+   "id": "869dea11",
    "metadata": {
     "tags": []
    },
@@ -160,7 +160,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "05c6cb0f",
+   "id": "8b6b3b4e",
    "metadata": {
     "tags": []
    },
@@ -171,7 +171,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "87b27885",
+   "id": "bf72f570",
    "metadata": {
     "tags": []
    },
@@ -195,7 +195,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "ac87bcb8",
+   "id": "0a9d6d5b",
    "metadata": {
     "tags": []
    },
@@ -206,7 +206,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "28c194db",
+   "id": "529bb3cb",
    "metadata": {
     "tags": []
    },
@@ -245,7 +245,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.9.7"
+   "version": "3.10.0"
   }
  },
  "nbformat": 4,
diff --git a/notebooks/mapper_api.ipynb b/notebooks/mapper_api.ipynb
index 78feaa42..ac64f904 100644
--- a/notebooks/mapper_api.ipynb
+++ b/notebooks/mapper_api.ipynb
@@ -3,7 +3,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "721418b4",
+   "id": "377440f0",
    "metadata": {
     "tags": []
    },
@@ -17,7 +17,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "664dd6e6",
+   "id": "6928e36d",
    "metadata": {
     "tags": []
    },
@@ -35,7 +35,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "7f70a493",
+   "id": "23685727",
    "metadata": {
     "tags": []
    },
@@ -47,7 +47,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "0fea8fe2",
+   "id": "f3bcfbfa",
    "metadata": {
     "tags": []
    },
@@ -69,7 +69,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "a0b6c4f8",
+   "id": "b145ef68",
    "metadata": {
     "tags": []
    },
@@ -80,7 +80,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "9fb4c33b",
+   "id": "edaf8266",
    "metadata": {
     "tags": []
    },
@@ -102,7 +102,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "3eb69bd9",
+   "id": "c470c0ee",
    "metadata": {
     "tags": []
    },
@@ -113,7 +113,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "aa807a15",
+   "id": "8a80b7f4",
    "metadata": {
     "tags": []
    },
@@ -135,7 +135,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "380b7733",
+   "id": "5c7493b8",
    "metadata": {
     "tags": []
    },
@@ -146,7 +146,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "11669027",
+   "id": "81a696c0",
    "metadata": {
     "tags": []
    },
@@ -158,7 +158,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "c74a8da1",
+   "id": "f9889d34",
    "metadata": {
     "tags": []
    },
@@ -180,7 +180,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "2be455db",
+   "id": "9e089a72",
    "metadata": {
     "tags": []
    },
@@ -191,7 +191,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "198420d8",
+   "id": "3d628965",
    "metadata": {
     "tags": []
    },
@@ -214,7 +214,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "f30849de",
+   "id": "b18038a3",
    "metadata": {
     "tags": []
    },
@@ -236,7 +236,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "641ec21e",
+   "id": "b8f6885a",
    "metadata": {
     "tags": []
    },
@@ -258,7 +258,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "778e5dd4",
+   "id": "e7f98b40",
    "metadata": {
     "tags": []
    },
@@ -269,7 +269,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "c508df6c",
+   "id": "7c8113f5",
    "metadata": {
     "tags": []
    },
@@ -280,7 +280,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "bd61e9f6",
+   "id": "124b2145",
    "metadata": {
     "tags": []
    },
@@ -291,7 +291,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "e67d8662",
+   "id": "661c88db",
    "metadata": {
     "tags": []
    },
@@ -328,7 +328,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.9.7"
+   "version": "3.10.0"
   }
  },
  "nbformat": 4,
diff --git a/notebooks/nested_dataclass.ipynb b/notebooks/nested_dataclass.ipynb
index 66f05a07..5fc907ab 100644
--- a/notebooks/nested_dataclass.ipynb
+++ b/notebooks/nested_dataclass.ipynb
@@ -2,7 +2,7 @@
  "cells": [
   {
    "cell_type": "markdown",
-   "id": "8464d7f9",
+   "id": "45e0042e",
    "metadata": {
     "tags": []
    },
@@ -13,7 +13,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "db808a4d",
+   "id": "38367536",
    "metadata": {
     "tags": []
    },
@@ -27,7 +27,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "997d6f18",
+   "id": "e3255ffc",
    "metadata": {
     "tags": []
    },
@@ -50,7 +50,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "84261eb9",
+   "id": "10cca31f",
    "metadata": {
     "tags": []
    },
@@ -61,7 +61,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "dd1cfcd7",
+   "id": "cca899bf",
    "metadata": {
     "tags": []
    },
@@ -73,7 +73,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "0d3d460e",
+   "id": "095f54bf",
    "metadata": {
     "tags": []
    },
@@ -97,7 +97,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "e7692cdc",
+   "id": "071a36d2",
    "metadata": {
     "tags": []
    },
@@ -108,7 +108,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "d7054c21",
+   "id": "14abae1a",
    "metadata": {
     "tags": []
    },
@@ -119,7 +119,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "c5493376",
+   "id": "86300dd1",
    "metadata": {
     "tags": []
    },
@@ -130,7 +130,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "ffd0153e",
+   "id": "5804e95b",
    "metadata": {
     "tags": []
    },
@@ -155,7 +155,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "d9c0343f",
+   "id": "0b049f24",
    "metadata": {
     "tags": []
    },
@@ -179,7 +179,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.9.7"
+   "version": "3.10.0"
   }
  },
  "nbformat": 4,
diff --git a/notebooks/patched_containers.ipynb b/notebooks/patched_containers.ipynb
index 88dfdee9..a3b2d6e3 100644
--- a/notebooks/patched_containers.ipynb
+++ b/notebooks/patched_containers.ipynb
@@ -3,7 +3,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "09765470",
+   "id": "9c925c80",
    "metadata": {
     "tags": []
    },
@@ -17,7 +17,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "0e4b8e6f",
+   "id": "06a634c7",
    "metadata": {
     "tags": []
    },
@@ -45,7 +45,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "f83f85f3",
+   "id": "376cecf5",
    "metadata": {
     "tags": []
    },
@@ -56,7 +56,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "6e796621",
+   "id": "606bbc30",
    "metadata": {
     "tags": []
    },
@@ -69,7 +69,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "7d8aea01",
+   "id": "ea45fc6a",
    "metadata": {
     "tags": []
    },
@@ -93,7 +93,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "f8ae0a72",
+   "id": "90576938",
    "metadata": {
     "tags": []
    },
@@ -105,7 +105,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "360a5197",
+   "id": "a8e6b891",
    "metadata": {
     "tags": []
    },
@@ -130,7 +130,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "1e0506cb",
+   "id": "6370cca5",
    "metadata": {
     "tags": []
    },
@@ -142,7 +142,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "5c47b70c",
+   "id": "32a0f8eb",
    "metadata": {
     "tags": []
    },
@@ -165,7 +165,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "81fb0ca7",
+   "id": "9a23f290",
    "metadata": {
     "tags": []
    },
@@ -176,7 +176,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "55fc01e6",
+   "id": "494d4557",
    "metadata": {
     "tags": []
    },
@@ -188,7 +188,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "e9c99c93",
+   "id": "77866a81",
    "metadata": {
     "tags": []
    },
@@ -215,7 +215,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "60f612d3",
+   "id": "d5bfb78c",
    "metadata": {
     "tags": []
    },
@@ -227,7 +227,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "3960fb27",
+   "id": "c2b13b82",
    "metadata": {
     "tags": []
    },
@@ -255,7 +255,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "fd463ce6",
+   "id": "cd2df780",
    "metadata": {
     "tags": []
    },
@@ -278,7 +278,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "cccbbf79",
+   "id": "3908823e",
    "metadata": {
     "tags": []
    },
@@ -305,7 +305,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "d56668f2",
+   "id": "764d15c4",
    "metadata": {
     "tags": []
    },
@@ -329,7 +329,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.9.7"
+   "version": "3.10.0"
   }
  },
  "nbformat": 4,
diff --git a/notebooks/readme.ipynb b/notebooks/readme.ipynb
index 9c3e5ee1..e6c44bec 100644
--- a/notebooks/readme.ipynb
+++ b/notebooks/readme.ipynb
@@ -3,7 +3,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "11c7a5c8",
+   "id": "0e537da5",
    "metadata": {
     "tags": []
    },
@@ -16,7 +16,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "aab3aef4",
+   "id": "999ad03a",
    "metadata": {
     "tags": []
    },
@@ -27,7 +27,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "7da8acae",
+   "id": "43588250",
    "metadata": {
     "tags": []
    },
@@ -50,7 +50,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "42ccbfdb",
+   "id": "5d8b3ba1",
    "metadata": {
     "tags": []
    },
@@ -62,7 +62,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "000c5c01",
+   "id": "f0331fce",
    "metadata": {
     "tags": []
    },
@@ -83,7 +83,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "c17bb993",
+   "id": "c4843085",
    "metadata": {
     "tags": []
    },
@@ -94,7 +94,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "f7ea0354",
+   "id": "14427836",
    "metadata": {
     "tags": []
    },
@@ -106,7 +106,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "2cc09d1a",
+   "id": "88d4a712",
    "metadata": {
     "tags": []
    },
@@ -128,7 +128,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "26051aff",
+   "id": "2a9299fe",
    "metadata": {
     "tags": []
    },
@@ -139,7 +139,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "8dfdb708",
+   "id": "e164d1f4",
    "metadata": {
     "tags": []
    },
@@ -148,7 +148,14 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Overwriting inventory/items/widget.yml\n"
+      "Overwriting inventory/items/widget.yml"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\n"
      ]
     }
    ],
@@ -162,7 +169,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "4bd42759",
+   "id": "6f1306d5",
    "metadata": {
     "tags": []
    },
@@ -184,7 +191,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "69ece893",
+   "id": "b6f95180",
    "metadata": {
     "tags": []
    },
@@ -195,7 +202,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "35c9a163",
+   "id": "f5fc2812",
    "metadata": {
     "tags": []
    },
@@ -226,7 +233,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.9.7"
+   "version": "3.10.0"
   }
  },
  "nbformat": 4,
diff --git a/notebooks/roundtrip_comments.ipynb b/notebooks/roundtrip_comments.ipynb
index 2fffd17b..729e0282 100644
--- a/notebooks/roundtrip_comments.ipynb
+++ b/notebooks/roundtrip_comments.ipynb
@@ -2,7 +2,7 @@
  "cells": [
   {
    "cell_type": "markdown",
-   "id": "0b7cca58",
+   "id": "5f263baa",
    "metadata": {
     "tags": []
    },
@@ -13,7 +13,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "0fefe521",
+   "id": "0502a6b9",
    "metadata": {
     "tags": []
    },
@@ -27,7 +27,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "8af87b27",
+   "id": "bb5cbddc",
    "metadata": {
     "tags": []
    },
@@ -43,7 +43,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "092abe35",
+   "id": "bc7a232d",
    "metadata": {
     "tags": []
    },
@@ -54,7 +54,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "ad965e23",
+   "id": "53314ebb",
    "metadata": {
     "tags": []
    },
@@ -66,7 +66,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "4c379ea4",
+   "id": "669fc69e",
    "metadata": {
     "tags": []
    },
@@ -88,7 +88,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "a78faea6",
+   "id": "5ff85046",
    "metadata": {
     "tags": []
    },
@@ -99,7 +99,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "f93717dd",
+   "id": "b53e1c29",
    "metadata": {
     "tags": []
    },
@@ -124,7 +124,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "db30ecd0",
+   "id": "7c572243",
    "metadata": {
     "tags": []
    },
@@ -149,7 +149,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "99b3b85e",
+   "id": "8c124a31",
    "metadata": {
     "tags": []
    },
@@ -160,7 +160,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "ab956128",
+   "id": "ca6b51b6",
    "metadata": {
     "tags": []
    },
@@ -172,7 +172,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "e03abb5d",
+   "id": "4c619fcc",
    "metadata": {
     "tags": []
    },
@@ -183,7 +183,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "1d25eb6a",
+   "id": "e30a67af",
    "metadata": {
     "tags": []
    },
@@ -222,7 +222,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.9.7"
+   "version": "3.10.0"
   }
  },
  "nbformat": 4,
diff --git a/poetry.lock b/poetry.lock
index 34cbfd06..9a039086 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -277,19 +277,20 @@ python-versions = ">=3.5"
 
 [[package]]
 name = "importlib-metadata"
-version = "4.0.1"
+version = "4.12.0"
 description = "Read metadata from Python packages"
 category = "dev"
 optional = false
-python-versions = ">=3.6"
+python-versions = ">=3.7"
 
 [package.dependencies]
 typing-extensions = {version = ">=3.6.4", markers = "python_version < \"3.8\""}
 zipp = ">=0.5"
 
 [package.extras]
-docs = ["sphinx", "jaraco.packaging (>=8.2)", "rst.linker (>=1.9)"]
-testing = ["pytest (>=4.6)", "pytest-checkdocs (>=2.4)", "pytest-flake8", "pytest-cov", "pytest-enabler (>=1.0.1)", "packaging", "pep517", "pyfakefs", "flufl.flake8", "pytest-black (>=0.3.7)", "pytest-mypy", "importlib-resources (>=1.3)"]
+docs = ["sphinx", "jaraco.packaging (>=9)", "rst.linker (>=1.9)"]
+perf = ["ipython"]
+testing = ["pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-flake8", "pytest-cov", "pytest-enabler (>=1.3)", "packaging", "pyfakefs", "flufl.flake8", "pytest-perf (>=0.9.2)", "pytest-black (>=0.3.7)", "pytest-mypy (>=0.9.1)", "importlib-resources (>=1.3)"]
 
 [[package]]
 name = "iniconfig"
@@ -597,7 +598,7 @@ python-versions = "*"
 
 [[package]]
 name = "mkdocs"
-version = "1.2.3"
+version = "1.3.1"
 description = "Project documentation with Markdown."
 category = "dev"
 optional = false
@@ -606,9 +607,9 @@ python-versions = ">=3.6"
 [package.dependencies]
 click = ">=3.3"
 ghp-import = ">=1.0"
-importlib-metadata = ">=3.10"
-Jinja2 = ">=2.10.1"
-Markdown = ">=3.2.1"
+importlib-metadata = ">=4.3"
+Jinja2 = ">=2.10.2"
+Markdown = ">=3.2.1,<3.4"
 mergedeep = ">=1.3.4"
 packaging = ">=20.5"
 PyYAML = ">=3.10"
@@ -1460,7 +1461,7 @@ testing = ["pytest (>=4.6)", "pytest-checkdocs (>=1.2.3)", "pytest-flake8", "pyt
 [metadata]
 lock-version = "1.1"
 python-versions = "^3.7"
-content-hash = "cc3301e9c64ba1e3b8c4ef86909c386e8ad5baff38765dff09c5e96450cdf8fb"
+content-hash = "1bfa9c6c1adeb478f6f69319e384be24b4694d03b266c2f4c98499c8c2cae856"
 
 [metadata.files]
 ansiwrap = [
@@ -1702,10 +1703,7 @@ idna = [
     {file = "idna-3.3-py3-none-any.whl", hash = "sha256:84d9dd047ffa80596e0f246e2eab0b391788b0503584e8945f2368256d2735ff"},
     {file = "idna-3.3.tar.gz", hash = "sha256:9d643ff0a55b762d5cdb124b8eaa99c66322e2157b69160bc32796e824360e6d"},
 ]
-importlib-metadata = [
-    {file = "importlib_metadata-4.0.1-py3-none-any.whl", hash = "sha256:d7eb1dea6d6a6086f8be21784cc9e3bcfa55872b52309bc5fad53a8ea444465d"},
-    {file = "importlib_metadata-4.0.1.tar.gz", hash = "sha256:8c501196e49fb9df5df43833bdb1e4328f64847763ec8a50703148b73784d581"},
-]
+importlib-metadata = []
 iniconfig = [
     {file = "iniconfig-1.1.1-py2.py3-none-any.whl", hash = "sha256:011e24c64b7f47f6ebd835bb12a743f2fbe9a26d4cecaa7f53bc4f35ee9da8b3"},
     {file = "iniconfig-1.1.1.tar.gz", hash = "sha256:bc3af051d7d14b2ee5ef9969666def0cd1a000e121eaea580d4a313df4b37f32"},
@@ -1857,10 +1855,7 @@ mistune = [
     {file = "mistune-0.8.4-py2.py3-none-any.whl", hash = "sha256:88a1051873018da288eee8538d476dffe1262495144b33ecb586c4ab266bb8d4"},
     {file = "mistune-0.8.4.tar.gz", hash = "sha256:59a3429db53c50b5c6bcc8a07f8848cb00d7dc8bdb431a4ab41920d201d4756e"},
 ]
-mkdocs = [
-    {file = "mkdocs-1.2.3-py3-none-any.whl", hash = "sha256:a1fa8c2d0c1305d7fc2b9d9f607c71778572a8b110fb26642aa00296c9e6d072"},
-    {file = "mkdocs-1.2.3.tar.gz", hash = "sha256:89f5a094764381cda656af4298727c9f53dc3e602983087e1fe96ea1df24f4c1"},
-]
+mkdocs = []
 mypy = [
     {file = "mypy-0.910-cp35-cp35m-macosx_10_9_x86_64.whl", hash = "sha256:a155d80ea6cee511a3694b108c4494a39f42de11ee4e61e72bc424c490e46457"},
     {file = "mypy-0.910-cp35-cp35m-manylinux1_x86_64.whl", hash = "sha256:b94e4b785e304a04ea0828759172a15add27088520dc7e49ceade7834275bedb"},
@@ -1910,10 +1905,7 @@ nest-asyncio = [
     {file = "nest_asyncio-1.5.1-py3-none-any.whl", hash = "sha256:76d6e972265063fe92a90b9cc4fb82616e07d586b346ed9d2c89a4187acea39c"},
     {file = "nest_asyncio-1.5.1.tar.gz", hash = "sha256:afc5a1c515210a23c461932765691ad39e8eba6551c055ac8d5546e69250d0aa"},
 ]
-notebook = [
-    {file = "notebook-6.4.12-py3-none-any.whl", hash = "sha256:8c07a3bb7640e371f8a609bdbb2366a1976c6a2589da8ef917f761a61e3ad8b1"},
-    {file = "notebook-6.4.12.tar.gz", hash = "sha256:6268c9ec9048cff7a45405c990c29ac9ca40b0bc3ec29263d218c5e01f2b4e86"},
-]
+notebook = []
 packaging = [
     {file = "packaging-20.9-py2.py3-none-any.whl", hash = "sha256:67714da7f7bc052e064859c05c595155bd1ee9f69f76557e21f051443c20947a"},
     {file = "packaging-20.9.tar.gz", hash = "sha256:5b327ac1320dc863dca72f4514ecc086f31186744b84a230374cc1fd776feae5"},
@@ -2141,10 +2133,6 @@ requests = [
     {file = "ruamel.yaml-0.17.21.tar.gz", hash = "sha256:8b7ce697a2f212752a35c1ac414471dc16c424c9573be4926b56ff3f5d23b7af"},
 ]
 "ruamel.yaml.clib" = [
-    {file = "ruamel.yaml.clib-0.2.6-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:6e7be2c5bcb297f5b82fee9c665eb2eb7001d1050deaba8471842979293a80b0"},
-    {file = "ruamel.yaml.clib-0.2.6-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_24_x86_64.whl", hash = "sha256:221eca6f35076c6ae472a531afa1c223b9c29377e62936f61bc8e6e8bdc5f9e7"},
-    {file = "ruamel.yaml.clib-0.2.6-cp310-cp310-win32.whl", hash = "sha256:1070ba9dd7f9370d0513d649420c3b362ac2d687fe78c6e888f5b12bf8bc7bee"},
-    {file = "ruamel.yaml.clib-0.2.6-cp310-cp310-win_amd64.whl", hash = "sha256:77df077d32921ad46f34816a9a16e6356d8100374579bc35e15bab5d4e9377de"},
     {file = "ruamel.yaml.clib-0.2.6-cp35-cp35m-macosx_10_6_intel.whl", hash = "sha256:cfdb9389d888c5b74af297e51ce357b800dd844898af9d4a547ffc143fa56751"},
     {file = "ruamel.yaml.clib-0.2.6-cp35-cp35m-manylinux1_x86_64.whl", hash = "sha256:7b2927e92feb51d830f531de4ccb11b320255ee95e791022555971c466af4527"},
     {file = "ruamel.yaml.clib-0.2.6-cp35-cp35m-win32.whl", hash = "sha256:ada3f400d9923a190ea8b59c8f60680c4ef8a4b0dfae134d2f2ff68429adfab5"},
diff --git a/pyproject.toml b/pyproject.toml
index 2d0a566e..54bb3e6e 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -84,7 +84,7 @@ pytest-profiling = "*"
 coveragespace = "^4.0"
 
 # Documentation
-mkdocs = "^1.2.3"
+mkdocs = "^1.3"
 pygments = "^2.10"
 jinja2 = "~3.0.3" # fix for 'mkdocs' incompatiblity