fix: improve docstring wording of display methods (#3120)

* fix: Improve docstring wording of 'for regular members'

* Improve docstring wording of display methods

* style(pre-commit): auto fixes from pre-commit.com hooks

* Update discord/user.py

Signed-off-by: Paillat <jeremiecotti@ik.me>

---------

Signed-off-by: Paillat <jeremiecotti@ik.me>
Co-Authored-By: ffouqueray <flavien.fouqueray@icloud.com>
Co-Authored-By: Paillat <paillat@pycord.dev>
Co-Authored-By: Dorukyum <53639936+Dorukyum@users.noreply.github.com>
Co-Authored-By: Lala Sabathil <lala@pycord.dev>
Co-Authored-By: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-Authored-By: Paillat <jeremiecotti@ik.me>

Author: 6 people

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
         """