diff --git a/docs/authentication.mdx b/docs/authentication.mdx
index 465ec857a..83469c4d6 100644
--- a/docs/authentication.mdx
+++ b/docs/authentication.mdx
@@ -11,6 +11,8 @@ Continuwuity implements the following authentication flows:
 
 Different sets of clients support different flows, but most clients are moving towards next-gen auth. One can set which login mode(s) are allowed via the `compatibility_mode` variable of the `[global.oauth]` config file section.
 
+{/* TODO: !important Annontation block for .well-known/matrix/client requirement */}
+
 ## Authentication sources
 
 Continuwuity can read user authentication data from the following sources:
@@ -27,4 +29,4 @@ When configuring Delegated authentication, **legacy login will be implicitly dis
 See the following pages for further details:
 
 - [**Registration and email configuration**](./authentication/registration)
-- [**Delegated authentication**](./authentication/oidc)
\ No newline at end of file
+- [**Delegated authentication**](./authentication/oidc)
diff --git a/docs/authentication/oidc.mdx b/docs/authentication/oidc.mdx
index 1d053c2fc..519c6b37c 100644
--- a/docs/authentication/oidc.mdx
+++ b/docs/authentication/oidc.mdx
@@ -61,3 +61,7 @@ client_secret = "d1qgx352kkuvs1j70b6w293d65x68jve1f7b27fyk90gjhpr"
 Finally, restart Continuwuity, and log out and back in again. Your client should prompt you to continue in your web browser and open a webpage with the Continuwuity logo that allows you to continue in your identity provider. Once you log in successfully, you will be prompted to choose a user ID -- to link your existing account, enter its user ID, and then your old password when prompted.
 
 Continuwuity offers several additional configuration options to tweak its integration with your identity provider. Review the `[global.oauth.oidc]` section towards the bottom of the [reference configuration](../reference/config) for a complete list of options and documentation.
+
+{/* TODO: Section on OIDC decommissioning */}
+
+{/* TODO: Section on minting tokens */}
\ No newline at end of file