Document performance of advance_to
diff --git a/src/discouraged.rs b/src/discouraged.rs
index 48b0fa9..6e3b43d 100644
--- a/src/discouraged.rs
+++ b/src/discouraged.rs
@@ -144,6 +144,11 @@
     /// [RFC#2544]: https://github.com/rust-lang/rfcs/pull/2544
     /// [`PathSegment`]: ../../struct.PathSegment.html
     ///
+    /// # Performance
+    ///
+    /// This method performs a cheap fixed amount of work that does not depend
+    /// on how far apart the two streams are positioned.
+    ///
     /// # Panics
     ///
     /// The forked stream that this joins with must be derived by forking this parse stream.