diff --git a/src/ristretto.rs b/src/ristretto.rs
index aac5e67..4f4a703 100644
--- a/src/ristretto.rs
+++ b/src/ristretto.rs
@@ -69,8 +69,10 @@
 //! ## Scalars
 //!
 //! Scalars are represented by the `Scalar` struct.  Each scalar has a
-//! canonical representative mod the group order; see
-//! `Scalar::from_canonical_bytes()` and `Scalar::is_canonical()`.
+//! canonical representative mod the group order.  To attempt to load
+//! a supposedly-canonical scalar, use
+//! `Scalar::from_canonical_bytes()`. To check whether a
+//! representative is canonical, use `Scalar::is_canonical()`.
 //!
 //! ## Scalar Multiplication
 //!