diff --git a/library/core/src/main/java/com/google/android/exoplayer2/ExoPlayer.java b/library/core/src/main/java/com/google/android/exoplayer2/ExoPlayer.java
index 635a4051c9..21851f3d5b 100644
--- a/library/core/src/main/java/com/google/android/exoplayer2/ExoPlayer.java
+++ b/library/core/src/main/java/com/google/android/exoplayer2/ExoPlayer.java
@@ -457,10 +457,30 @@ public interface ExoPlayer extends Player {
           new DefaultMediaSourceFactory(context, new DefaultExtractorsFactory()));
     }
 
+    /**
+     * Creates a builder with a custom {@link MediaSourceFactory}.
+     *
+     * <p>See {@link #Builder(Context)} for a list of default values.
+     *
+     * @param context A {@link Context}.
+     * @param mediaSourceFactory A factory for creating a {@link MediaSource} from a {@link
+     *     MediaItem}.
+     */
     public Builder(Context context, MediaSourceFactory mediaSourceFactory) {
       this(context, new DefaultRenderersFactory(context), mediaSourceFactory);
     }
 
+    /**
+     * Creates a builder with a custom {@link RenderersFactory} and {@link MediaSourceFactory}.
+     *
+     * <p>See {@link #Builder(Context)} for a list of default values.
+     *
+     * @param context A {@link Context}.
+     * @param renderersFactory A factory for creating {@link Renderer Renderers} to be used by the
+     *     player.
+     * @param mediaSourceFactory A factory for creating a {@link MediaSource} from a {@link
+     *     MediaItem}.
+     */
     public Builder(
         Context context, RenderersFactory renderersFactory, MediaSourceFactory mediaSourceFactory) {
       this(