diff --git a/moshi/src/main/java/com/squareup/moshi/JsonReader.java b/moshi/src/main/java/com/squareup/moshi/JsonReader.java
index 814f1d1..cef68af 100644
--- a/moshi/src/main/java/com/squareup/moshi/JsonReader.java
+++ b/moshi/src/main/java/com/squareup/moshi/JsonReader.java
@@ -83,7 +83,7 @@ import okio.ByteString;
  * ]}</pre>
  * This code implements the parser for the above structure: <pre>   {@code
  *
- *   public List<Message> readJsonStream(Source source) throws IOException {
+ *   public List<Message> readJsonStream(BufferedSource source) throws IOException {
  *     JsonReader reader = new JsonReader(source);
  *     try {
  *       return readMessagesArray(reader);
diff --git a/moshi/src/main/java/com/squareup/moshi/JsonWriter.java b/moshi/src/main/java/com/squareup/moshi/JsonWriter.java
index 40566d8..a6af844 100644
--- a/moshi/src/main/java/com/squareup/moshi/JsonWriter.java
+++ b/moshi/src/main/java/com/squareup/moshi/JsonWriter.java
@@ -75,7 +75,7 @@ import static com.squareup.moshi.JsonScope.NONEMPTY_OBJECT;
  *   }
  * ]}</pre>
  * This code encodes the above structure: <pre>   {@code
- *   public void writeJsonStream(Sink sink, List<Message> messages) throws IOException {
+ *   public void writeJsonStream(BufferedSink sink, List<Message> messages) throws IOException {
  *     JsonWriter writer = new JsonWriter(sink);
  *     writer.setIndentSpaces(4);
  *     writeMessagesArray(writer, messages);