From a2cf2221170e333d1d1883e0e86c5efca32f55ba Mon Sep 17 00:00:00 2001
From: bachinger <bachinger@google.com>
Date: Wed, 11 Jan 2023 16:24:55 +0000
Subject: [PATCH] Improve Java doc about how to override notification drawables

Issue: androidx/media#140
PiperOrigin-RevId: 501288267
---
 .../session/DefaultMediaNotificationProvider.java      | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/libraries/session/src/main/java/androidx/media3/session/DefaultMediaNotificationProvider.java b/libraries/session/src/main/java/androidx/media3/session/DefaultMediaNotificationProvider.java
index b0fd6bc36a..c3acb2a83d 100644
--- a/libraries/session/src/main/java/androidx/media3/session/DefaultMediaNotificationProvider.java
+++ b/libraries/session/src/main/java/androidx/media3/session/DefaultMediaNotificationProvider.java
@@ -84,8 +84,10 @@ import org.checkerframework.checker.nullness.qual.MonotonicNonNull;
  *
  * <h2>Drawables</h2>
  *
- * The drawables used can be overridden by drawables with the same names defined the application.
- * The drawables are:
+ * The drawables used can be overridden by drawables with the same file names in {@code
+ * res/drawables} of the application module. Alternatively, you can override the drawable resource
+ * ID with a {@code drawable} element in a resource file in {@code res/values}. The drawable
+ * resource IDs are:
  *
  * <ul>
  *   <li><b>{@code media3_notification_play}</b> - The play icon.
@@ -99,8 +101,8 @@ import org.checkerframework.checker.nullness.qual.MonotonicNonNull;
  *
  * <h2>String resources</h2>
  *
- * String resources used can be overridden by resources with the same names defined the application.
- * These are:
+ * String resources used can be overridden by resources with the same resource IDs defined by the
+ * application. The string resource IDs are:
  *
  * <ul>
  *   <li><b>{@code media3_controls_play_description}</b> - The description of the play icon.