diff --git a/shared/src/main/scala/com/comcast/ip4s/Cidr.scala b/shared/src/main/scala/com/comcast/ip4s/Cidr.scala
index bcb0a67..6f508a7 100644
--- a/shared/src/main/scala/com/comcast/ip4s/Cidr.scala
+++ b/shared/src/main/scala/com/comcast/ip4s/Cidr.scala
@@ -37,6 +37,11 @@ sealed class Cidr[+A <: IpAddress] protected (val address: A, val prefixBits: In
     * is (and prints as) a spec-valid cidr range, with no bits outside the routing mask set.
     *
     * @return a normalized cidr range
+    *
+    * @example {{{
+    * scala> Cidr(ipv4"10.11.12.13", 8).normalized
+    * res0: Cidr.Strict[Ipv4Address] = 10.0.0.0/8
+    * }}}
     */
   def normalized: Strict[A] = Cidr.Strict(this)