From 2f4000d7b2baf37ed2077c1025da8a4313c4a29d Mon Sep 17 00:00:00 2001
From: blord0 <admin@blord.xyz>
Date: Wed, 18 Jun 2025 16:29:34 +0100
Subject: [PATCH] Add docs for PrimaryGuild

---
 discord/__init__.py      | 1 +
 discord/primary_guild.py | 1 +
 docs/api.rst             | 8 ++++++++
 3 files changed, 10 insertions(+)

diff --git a/discord/__init__.py b/discord/__init__.py
index 48fe10925..3e6e1c0e6 100644
--- a/discord/__init__.py
+++ b/discord/__init__.py
@@ -73,6 +73,7 @@ from .poll import *
 from .soundboard import *
 from .subscription import *
 from .presences import *
+from .primary_guild import *
 
 
 class VersionInfo(NamedTuple):
diff --git a/discord/primary_guild.py b/discord/primary_guild.py
index 6c5b637fe..afc84e2d4 100644
--- a/discord/primary_guild.py
+++ b/discord/primary_guild.py
@@ -36,6 +36,7 @@ if TYPE_CHECKING:
 
 
 class PrimaryGuild:
+    r"""Represents the primary guild (formally known as a clan) of a :class:`User`"""
     __slots__ = ('_guild_id', 'identity_enabled', '_tag', '_badge', '_state')
 
     if TYPE_CHECKING:
diff --git a/docs/api.rst b/docs/api.rst
index e366f63bf..6d2f1fc7f 100644
--- a/docs/api.rst
+++ b/docs/api.rst
@@ -5453,6 +5453,14 @@ ClientStatus
 .. autoclass:: ClientStatus()
     :members:
 
+PrimaryGuild
+~~~~~~~~~~~~
+
+.. attributetable:: PrimaryGuild
+
+.. autoclass:: PrimaryGuild()
+    :members:
+
 Data Classes
 --------------