docs: 📝 Document PrimaryGuild and User.primary_guild (#2937)

* 📝 Document `PrimaryGuild` and `User.primary_guild`

* 🩹 Import `PrimaryGuild` in `__init__.py`

* 📝 Requested changes

Author: Paillat-dev

discord/__init__.py

@@ -61,6 +61,7 @@
 from .permissions import *
 from .player import *
 from .poll import *
+from .primary_guild import *
 from .raw_models import *
 from .reaction import *
 from .role import *

discord/user.py

@@ -556,6 +556,10 @@ class User(BaseUser, discord.abc.Messageable):
     nameplate: Optional[:class:`Nameplate`]
         The user's nameplate, if the user has one.
 
+        .. versionadded:: 2.7
+    primary_guild: Optional[:class:`PrimaryGuild`]
+        The user's primary guild, if the user has one. Represent what guild the user's tag is from.
+
         .. versionadded:: 2.7
     """
 

docs/api/models.rst

@@ -71,6 +71,11 @@ Users
     .. automethod:: typing
         :async-with:
 
+.. attributetable:: PrimaryGuild
+
+.. autoclass:: PrimaryGuild()
+    :members:
+
 Messages
 --------