diff --git a/README.md b/README.md
index 62afe30..f0d940d 100644
--- a/README.md
+++ b/README.md
@@ -118,3 +118,5 @@ contributions.
 [ed25519-dalek]: https://github.com/dalek-cryptography/ed25519-dalek
 [x25519-dalek]: https://github.com/dalek-cryptography/x25519-dalek
 [contributing]: https://github.com/dalek-cryptography/curve25519-dalek/blob/master/CONTRIBUTING.md
+[docs-external]: https://doc.dalek.rs/curve25519_dalek/
+[docs-internal]: https://doc-internal.dalek.rs/curve25519_dalek/
diff --git a/src/ristretto.rs b/src/ristretto.rs
index 6c30121..d92bbdd 100644
--- a/src/ristretto.rs
+++ b/src/ristretto.rs
@@ -129,7 +129,7 @@
 //! gives the _Ristretto_ encoding.
 //!
 //! Notes on the details of the encoding can be found in the
-//! `ristretto::notes` submodule of the internal `curve25519-dalek`
+//! [`ristretto::notes`][ristretto_notes] submodule of the internal `curve25519-dalek`
 //! documentation.
 //!
 //! [cryptonote]:
@@ -138,6 +138,8 @@
 //! https://moderncrypto.org/mail-archive/curves/2017/000858.html
 //! [ristretto_coffee]:
 //! https://en.wikipedia.org/wiki/Ristretto
+//! [ristretto_notes]:
+//! https://doc-internal.dalek.rs/curve25519_dalek/ristretto/notes/index.html
 
 mod notes {