diff --git a/tracing-subscriber/src/fmt/fmt_subscriber.rs b/tracing-subscriber/src/fmt/fmt_subscriber.rs
index eec4c3241..405e7c77e 100644
--- a/tracing-subscriber/src/fmt/fmt_subscriber.rs
+++ b/tracing-subscriber/src/fmt/fmt_subscriber.rs
@@ -266,6 +266,8 @@ impl<C, N, E, W> Subscriber<C, N, E, W> {
     ///
     /// See [`TestWriter`] for additional details.
     ///
+    /// This method replaces any writer previously configured by [`with_writer`].
+    ///
     /// # Examples
     ///
     /// Using [`TestWriter`] to let `cargo test` capture test output:
@@ -283,6 +285,7 @@ impl<C, N, E, W> Subscriber<C, N, E, W> {
     /// [capturing]:
     /// https://doc.rust-lang.org/book/ch11-02-running-tests.html#showing-function-output
     /// [`TestWriter`]: super::writer::TestWriter
+    /// [`with_writer`]: Subscriber::with_writer
     pub fn with_test_writer(self) -> Subscriber<C, N, E, TestWriter> {
         Subscriber {
             fmt_fields: self.fmt_fields,