diff --git a/docs/authentication.mdx b/docs/authentication.mdx
index 9c8a9e138..e9d899fa0 100644
--- a/docs/authentication.mdx
+++ b/docs/authentication.mdx
@@ -1 +1,5 @@
 # Authentication
+
+{/* TODO: explain internal authn vs delegated authn */}
+
+{/* TODO: consider explaining UIA authz versus OAuth authz here */}
\ No newline at end of file
diff --git a/docs/authentication/oidc.mdx b/docs/authentication/oidc.mdx
new file mode 100644
index 000000000..3fe6343e1
--- /dev/null
+++ b/docs/authentication/oidc.mdx
@@ -0,0 +1,3 @@
+# OIDC delegated authentication
+
+{/* TODO: copy stuff over from guides/oidc.mdx and refactor */}
\ No newline at end of file
diff --git a/docs/authentication/registration.mdx b/docs/authentication/registration.mdx
index b8e91bd34..c8ce691a4 100644
--- a/docs/authentication/registration.mdx
+++ b/docs/authentication/registration.mdx
@@ -35,3 +35,5 @@ All email options are in the `[global.smtp]` block of the configuration file, an
 connection_uri = "smtps://john%40example.com:password@mail.example.net:465"
 sender = "John's Continuwuity server <john@example.com>"
 ```
+
+{/* TODO: Add relevant admin commands for email */}