diff --git a/src/scalar.rs b/src/scalar.rs
index 945691c..d4c921e 100644
--- a/src/scalar.rs
+++ b/src/scalar.rs
@@ -436,6 +436,21 @@ impl Scalar {
     /// # Returns
     ///
     /// A random scalar within ℤ/lℤ.
+    ///
+    /// # Example
+    ///
+    /// ```
+    /// extern crate rand;
+    /// # extern crate curve25519_dalek;
+    /// #
+    /// # fn main() {
+    /// use curve25519_dalek::scalar::Scalar;
+    ///
+    /// use rand::OsRng;
+    ///
+    /// let mut csprng: OsRng = OsRng::new().unwrap();
+    /// let a: Scalar = Scalar::random(&mut csprng);
+    /// # }
     #[cfg(feature = "std")]
     pub fn random<T: Rng + CryptoRng>(rng: &mut T) -> Self {
         let mut scalar_bytes = [0u8; 64];