diff --git a/README.md b/README.md
index f14e042c..99b25fb4 100644
--- a/README.md
+++ b/README.md
@@ -15,4 +15,4 @@ pip install caveclient
 
 ## Documentation
 
-You can find full documentation on readthedocs (https://seung-lab.github.io/CAVEclient).
+You can find full documentation at [seung-lab.github.io/CAVEclient](https://seung-lab.github.io/CAVEclient).
diff --git a/caveclient/base.py b/caveclient/base.py
index 4d130ab5..7fa4e139 100644
--- a/caveclient/base.py
+++ b/caveclient/base.py
@@ -105,7 +105,7 @@ def _check_authorization_redirect(response):
 {first_url}
 with the current auth configuration.\n
 Read the documentation at 
-https://caveclient.readthedocs.io/en/latest/guide/authentication.html
+https://seung-lab.github.io/CAVEclient/tutorials/authentication/
 or follow instructions under 
 client.auth.get_new_token() for how to set a valid API token.
 after initializing a global client with