diff --git a/changelog/47.docs.md b/changelog/47.docs.md
new file mode 100644
index 0000000..b4045b7
--- /dev/null
+++ b/changelog/47.docs.md
@@ -0,0 +1 @@
+Move docs on design decisions out of `src/openscm_units/_unit_registry.py` into a dedicated notebook.
diff --git a/changelog/47.trivial.md b/changelog/47.trivial.md
new file mode 100644
index 0000000..b2365f2
--- /dev/null
+++ b/changelog/47.trivial.md
@@ -0,0 +1,3 @@
+Move `unit_registry` from `src/openscm_units/_unit_registry.py` into `openscm_units/__init__.py`.
+This seems to be necessary to make the docs appear correctly without hacks (see [this issue](https://github.com/sphinx-doc/sphinx/issues/8547)).
+This does not affect users of the public API hence is a trivial change.