diff --git a/docs/source/authenticators.md b/docs/source/authenticators.md
index 6e3d370b..bc9de1fc 100644
--- a/docs/source/authenticators.md
+++ b/docs/source/authenticators.md
@@ -72,9 +72,9 @@ You can see an example implementation of an Authenticator that uses [GitHub OAut
 at [OAuthenticator][].
 
 
-[Authenticator]: ../jupyterhub/auth.py
-[PAM]: http://en.wikipedia.org/wiki/Pluggable_authentication_module
-[OAuth]: http://en.wikipedia.org/wiki/OAuth 
+[Authenticator]: https://github.com/jupyter/jupyterhub/blob/master/jupyterhub/auth.py
+[PAM]: https://en.wikipedia.org/wiki/Pluggable_authentication_module
+[OAuth]: https://en.wikipedia.org/wiki/OAuth 
 [GitHub OAuth]: https://developer.github.com/v3/oauth/
 [OAuthenticator]: https://github.com/jupyter/oauthenticator
 
diff --git a/docs/source/getting-started.md b/docs/source/getting-started.md
index bfcdda26..6957099d 100644
--- a/docs/source/getting-started.md
+++ b/docs/source/getting-started.md
@@ -6,7 +6,7 @@ JupyterHub is highly customizable, so there's a lot to cover.
 
 ## Installation
 
-See [the readme](../README.md) for help installing JupyterHub.
+See [the readme](https://github.com/jupyter/jupyterhub/blob/master/README.md) for help installing JupyterHub.
 
 
 ## Overview
@@ -404,4 +404,4 @@ jupyterhub -f /path/to/aboveconfig.py
 
 [oauth-setup]: https://github.com/jupyter/oauthenticator#setup
 [oauthenticator]: https://github.com/jupyter/oauthenticator
-[PAM]: http://en.wikipedia.org/wiki/Pluggable_authentication_module
+[PAM]: https://en.wikipedia.org/wiki/Pluggable_authentication_module
diff --git a/docs/source/howitworks.md b/docs/source/howitworks.md
index 6b6d9ab5..a8ae2e60 100644
--- a/docs/source/howitworks.md
+++ b/docs/source/howitworks.md
@@ -51,7 +51,7 @@ Authentication is customizable via the Authenticator class.
 Authentication can be replaced by any mechanism,
 such as OAuth, Kerberos, etc.
 
-JupyterHub only ships with [PAM](http://en.wikipedia.org/wiki/Pluggable_authentication_module) authentication,
+JupyterHub only ships with [PAM](https://en.wikipedia.org/wiki/Pluggable_authentication_module) authentication,
 which requires the server to be run as root,
 or at least with access to the PAM service,
 which regular users typically do not have
diff --git a/docs/source/spawners.md b/docs/source/spawners.md
index c672ee7e..5462dae3 100644
--- a/docs/source/spawners.md
+++ b/docs/source/spawners.md
@@ -100,7 +100,7 @@ If the `Spawner.options_form` is defined, when a user would start their server,
 
 If `Spawner.options_form` is undefined, the users server is spawned directly, and no spawn page is rendered.
 
-See [this example](../examples/spawn-form/jupyterhub_config.py) for a form that allows custom CLI args for the local spawner.
+See [this example](https://github.com/jupyter/jupyterhub/blob/master/examples/spawn-form/jupyterhub_config.py) for a form that allows custom CLI args for the local spawner.
 
 
 ### `Spawner.options_from_form`