docs: add warning to authenticator docs, linking to official docs

docs/howto/auth/awscognito.md

@@ -2,6 +2,18 @@
 
 # Authenticate using AWS Cognito
 
+```{warning}
+This documentation has not been updated recently, and a major version of
+OAuthenticator has been released since it was. Due to that, please only use this
+_as a complement_ to the official [OAuthenticator documentation].
+
+[OAuthenticator documentation]: https://oauthenticator.readthedocs.io/en/latest/tutorials/provider-specific-setup/providers/generic.html#setup-for-aws-cognito
+
+Going onwards, the goal is to ensure we have good documentation in the
+OAuthenticator project and reference that instead of maintaining similar
+documentation in this project also.
+```
+
 The **AWS Cognito Authenticator** lets users log into your JupyterHub using
 cognito user pools. To do so, you'll first need to register and configure a
 cognito user pool and app, and then provide information about this