docs: update required permissions for Guild.invites (#1348)

Author: shiftinv

changelog/1348.doc.rst

@@ -0,0 +1 @@
+Update required permissions for :meth:`Guild.invites` and in the invite attribute :ref:`table <invite_attr_table>`.

disnake/guild.py

@@ -3184,8 +3184,10 @@ async def invites(self) -> List[Invite]:
 
         Returns a list of all active instant invites from the guild.
 
-        You must have :attr:`~Permissions.manage_guild` permission to
-        use this.
+        You must have :attr:`~Permissions.manage_guild` or :attr:`~Permissions.view_audit_log`
+        permission to use this.
+        Some attributes (see :ref:`table <invite_attr_table>`) are only available with
+        :attr:`~Permissions.manage_guild` permissions.
 
         .. note::
 

disnake/invite.py

@@ -281,15 +281,20 @@ class Invite(Hashable):
     +------------------------------------+---------------------------------------------------------------------+
     |             Attribute              |                          Method                                     |
     +====================================+=====================================================================+
-    | :attr:`max_age`                    | :meth:`abc.GuildChannel.invites`\\, :meth:`Guild.invites`            |
+    | :attr:`max_age`                    | :meth:`Guild.invites` with :attr:`~Permissions.manage_guild`        |
+    |                                    | permissions, :meth:`abc.GuildChannel.invites`                       |
     +------------------------------------+---------------------------------------------------------------------+
-    | :attr:`max_uses`                   | :meth:`abc.GuildChannel.invites`\\, :meth:`Guild.invites`            |
+    | :attr:`max_uses`                   | :meth:`Guild.invites` with :attr:`~Permissions.manage_guild`        |
+    |                                    | permissions, :meth:`abc.GuildChannel.invites`                       |
     +------------------------------------+---------------------------------------------------------------------+
-    | :attr:`created_at`                 | :meth:`abc.GuildChannel.invites`\\, :meth:`Guild.invites`            |
+    | :attr:`created_at`                 | :meth:`Guild.invites` with :attr:`~Permissions.manage_guild`        |
+    |                                    | permissions, :meth:`abc.GuildChannel.invites`                       |
     +------------------------------------+---------------------------------------------------------------------+
-    | :attr:`temporary`                  | :meth:`abc.GuildChannel.invites`\\, :meth:`Guild.invites`            |
+    | :attr:`temporary`                  | :meth:`Guild.invites` with :attr:`~Permissions.manage_guild`        |
+    |                                    | permissions, :meth:`abc.GuildChannel.invites`                       |
     +------------------------------------+---------------------------------------------------------------------+
-    | :attr:`uses`                       | :meth:`abc.GuildChannel.invites`\\, :meth:`Guild.invites`            |
+    | :attr:`uses`                       | :meth:`Guild.invites` with :attr:`~Permissions.manage_guild`        |
+    |                                    | permissions, :meth:`abc.GuildChannel.invites`                       |
     +------------------------------------+---------------------------------------------------------------------+
     | :attr:`approximate_member_count`   | :meth:`Client.fetch_invite` with ``with_counts`` enabled            |
     +------------------------------------+---------------------------------------------------------------------+