docs: Docs cleanup

discord/member.py

@@ -663,9 +663,8 @@ def display_name(self) -> str:
     def display_avatar(self) -> Asset:
         """Returns the member's display avatar.
 
-        For regular members this is just their avatar, but
-        if they have a guild specific avatar then that
-        is returned instead.
+        Returns the user's guild avatar.
+        If the user does not have a guild avatar, their global avatar is returned instead.
 
         .. versionadded:: 2.0
         """
@@ -688,9 +687,8 @@ def guild_avatar(self) -> Asset | None:
     def display_avatar_decoration(self) -> Asset | None:
         """Returns the member's displayed avatar decoration.
 
-        For regular members this is just their avatar decoration, but
-        if they have a guild specific avatar decoration then that
-        is returned instead.
+        Returns the user's guild avatar decoration.
+        If the user does not have a guild avatar decoration, their global avatar decoration is returned instead.
 
         .. versionadded:: 2.8
         """
@@ -713,9 +711,8 @@ def guild_avatar_decoration(self) -> Asset | None:
     def display_banner(self) -> Asset | None:
         """Returns the member's display banner.
 
-        For regular members this is just their banner, but
-        if they have a guild specific banner then that
-        is returned instead.
+        Returns the user's guild banner.
+        If the user does not have a guild banner, their global banner is returned instead.
 
         .. versionadded:: 2.7
         """

discord/user.py

@@ -251,7 +251,8 @@ def default_avatar(self) -> Asset:
     def display_avatar(self) -> Asset:
         """Returns the user's display avatar.
 
-        For regular users this is just their default avatar or uploaded avatar.
+        Returns the user's uploaded avatar.
+        If the user has not uploaded any avatar, their default avatar is returned instead.
 
         .. versionadded:: 2.0
         """