From 4165d1b37eb7c4444457bfe473cdeb4af3c02f9e Mon Sep 17 00:00:00 2001
From: Behnam Mohammadi <itten@live.com>
Date: Thu, 14 Nov 2019 15:00:52 +0330
Subject: [PATCH 1/2] [Docs] Improve missing info

---
 packages/material-ui/src/Avatar/Avatar.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/material-ui/src/Avatar/Avatar.js b/packages/material-ui/src/Avatar/Avatar.js
index 3cc4fa1ac5544d..72f35acb959e46 100644
--- a/packages/material-ui/src/Avatar/Avatar.js
+++ b/packages/material-ui/src/Avatar/Avatar.js
@@ -137,7 +137,7 @@ Avatar.propTypes = {
    */
   src: PropTypes.string,
   /**
-   * The `srcSet` attribute for the `img` element.
+   * The `srcSet` attribute for the `img` element. Defines the set of images we will allow the browser to choose between by match size.
    */
   srcSet: PropTypes.string,
   /**

From d7fe9a1523b8048141e9c6e09095b24efd548d38 Mon Sep 17 00:00:00 2001
From: Olivier Tassinari <olivier.tassinari@gmail.com>
Date: Thu, 14 Nov 2019 14:04:52 +0100
Subject: [PATCH 2/2] shorter description

---
 docs/pages/api/avatar.md                  | 2 +-
 packages/material-ui/src/Avatar/Avatar.js | 3 ++-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/pages/api/avatar.md b/docs/pages/api/avatar.md
index 207105e87157c0..6db035aa37a66e 100644
--- a/docs/pages/api/avatar.md
+++ b/docs/pages/api/avatar.md
@@ -31,7 +31,7 @@ You can learn more about the difference by [reading this guide](/guides/minimizi
 | <span class="prop-name">imgProps</span> | <span class="prop-type">object</span> |  | Attributes applied to the `img` element if the component is used to display an image. |
 | <span class="prop-name">sizes</span> | <span class="prop-type">string</span> |  | The `sizes` attribute for the `img` element. |
 | <span class="prop-name">src</span> | <span class="prop-type">string</span> |  | The `src` attribute for the `img` element. |
-| <span class="prop-name">srcSet</span> | <span class="prop-type">string</span> |  | The `srcSet` attribute for the `img` element. |
+| <span class="prop-name">srcSet</span> | <span class="prop-type">string</span> |  | The `srcSet` attribute for the `img` element. Use this attribute for responsive image display. |
 | <span class="prop-name">variant</span> | <span class="prop-type">'circle'<br>&#124;&nbsp;'rounded'<br>&#124;&nbsp;'square'</span> | <span class="prop-default">'circle'</span> | The shape of the avatar. |
 
 The `ref` is forwarded to the root element.
diff --git a/packages/material-ui/src/Avatar/Avatar.js b/packages/material-ui/src/Avatar/Avatar.js
index 72f35acb959e46..95347e73d6bd61 100644
--- a/packages/material-ui/src/Avatar/Avatar.js
+++ b/packages/material-ui/src/Avatar/Avatar.js
@@ -137,7 +137,8 @@ Avatar.propTypes = {
    */
   src: PropTypes.string,
   /**
-   * The `srcSet` attribute for the `img` element. Defines the set of images we will allow the browser to choose between by match size.
+   * The `srcSet` attribute for the `img` element.
+   * Use this attribute for responsive image display.
    */
   srcSet: PropTypes.string,
   /**