fix(docs): fix linkcheck issues

Author: Lulalaby

.github/workflows/docs-checks.yml

@@ -17,6 +17,11 @@ on:
       - "*.toml"
       - "*.py"
   workflow_dispatch:
+    inputs:
+      with_linkcheck:
+        type: boolean
+        description: "Whether to run the linkcheck"
+        default: true
   schedule:
     - cron: "0 0 * * *"
 
@@ -44,7 +49,7 @@ jobs:
           python -m pip install -U pip
           pip install ".[docs]"
       - name: "Check Links"
-        if: ${{ github.event_name == 'schedule' }}
+        if: ${{ github.event_name == 'schedule' || inputs.with_linkcheck }}
         run: |
           cd docs
           make linkcheck

.gitignore

@@ -186,6 +186,7 @@ docs/changelog.md
 # Translations
 docs/build/html
 docs/build/doctrees
+docs/build/linkcheck
 !docs/build/locales/*
 *.mo
 !docs/locales/*

CHANGELOG.md

@@ -322,7 +322,6 @@ These changes are available on the `master` branch, but have not yet been releas
   ([#2185](https://github.com/Pycord-Development/pycord/pull/2185))
 - Fixed inaccurate `Union` type hint of `values` argument of `basic_autocomplete` to
   include `Iterable[OptionChoice]`.
-  ([#2164](https://github.com/Pycord-Development/pycord/pull/2164))
 - Fixed initial message inside of the create thread payload sending legacy beta payload.
   ([#2191](https://github.com/Pycord-Development/pycord/pull/2191))
 - Fixed a misplaced payload object inside of the thread creation payload.
@@ -652,7 +651,7 @@ These changes are available on the `master` branch, but have not yet been releas
 
 - Fix `VoiceChannel`/`CategoryChannel` data being invalidated on `Option._invoke`.
   ([#1490](https://github.com/Pycord-Development/pycord/pull/1490))
-- Fix type issues in options.py
+- Fix type issues in `options.py`
   ([#1473](https://github.com/Pycord-Development/pycord/pull/1473))
 - Fix KeyError on AutoModActionExecution when the bot lacks the Message Content Intent.
   ([#1521](https://github.com/Pycord-Development/pycord/pull/1521))
@@ -903,7 +902,7 @@ These changes are available on the `master` branch, but have not yet been releas
   ([#1240](https://github.com/Pycord-Development/pycord/pull/1240))
 
 [unreleased]: https://github.com/Pycord-Development/pycord/compare/v2.6.0...HEAD
-[2.6.0]: https://github.com/Pycord-Development/pycord/compare/v2.5.0...2.6.0
+[2.6.0]: https://github.com/Pycord-Development/pycord/compare/v2.5.0...v2.6.0
 [2.5.0]: https://github.com/Pycord-Development/pycord/compare/v2.4.1...v2.5.0
 [2.4.1]: https://github.com/Pycord-Development/pycord/compare/v2.4.0...v2.4.1
 [2.4.0]: https://github.com/Pycord-Development/pycord/compare/v2.3.3...v2.4.0

discord/guild.py

@@ -210,7 +210,7 @@ class Guild(Hashable):
     features: List[:class:`str`]
         A list of features that the guild has. The features that a guild can have are
         subject to arbitrary change by Discord. You can find a catalog of guild features
-        `here <https://github.com/Delitefully/DiscordLists#guild-feature-glossary>`_.
+        `here <https://github.com/Delitefully/DiscordLists?tab=readme-ov-file#guild-feature-glossary>`_.
     premium_tier: :class:`int`
         The premium tier for this guild. Corresponds to "Nitro Server" in the official UI.
         The number goes from 0 to 3 inclusive.

docs/build/locales/api/models.pot

@@ -7434,7 +7434,7 @@ msgstr ""
 
 #: ../../../discord/guild.py:docstring of discord.guild.Guild:141
 #: 96094a79a794453ca947a68e85a7ac9d
-msgid "A list of features that the guild has. The features that a guild can have are subject to arbitrary change by Discord. You can find a catalog of guild features `here <https://github.com/Delitefully/DiscordLists#guild-feature-glossary>`_."
+msgid "A list of features that the guild has. The features that a guild can have are subject to arbitrary change by Discord. You can find a catalog of guild features `here <https://github.com/Delitefully/DiscordLists?tab=readme-ov-file#guild-feature-glossary>`_."
 msgstr ""
 
 #: ../../../discord/automod.py:docstring of discord.automod.AutoModTriggerMetadata:29

docs/conf.py

@@ -480,6 +480,14 @@ def write_new():
     r"https://discord.com/developers/docs/.*#",
     r"https://support(?:-dev)?.discord.com/hc/en-us/articles/.*",
     r"https://dis.gd/contact",
+    r"https://guide.pycord.dev/",
+    r"https://guide.pycord.dev/.*",
+    r"https://pycord.dev/",
+    r"https://pycord.dev/.*"
+]
+
+linkcheck_anchors_ignore_for_url = [
+    r"https://github.com/Delitefully/DiscordLists"
 ]
 
 modindex_common_prefix = ["discord."]

docs/locales/de/LC_MESSAGES/api/models.po

@@ -1727,8 +1727,8 @@ msgstr "The guild's notification settings."
 msgid ":class:`NotificationLevel`"
 msgstr ":class:`NotificationLevel`"
 
-msgid "A list of features that the guild has. The features that a guild can have are subject to arbitrary change by Discord. You can find a catalog of guild features `here <https://github.com/Delitefully/DiscordLists#guild-feature-glossary>`_."
-msgstr "A list of features that the guild has. The features that a guild can have are subject to arbitrary change by Discord. You can find a catalog of guild features `here <https://github.com/Delitefully/DiscordLists#guild-feature-glossary>`_."
+msgid "A list of features that the guild has. The features that a guild can have are subject to arbitrary change by Discord. You can find a catalog of guild features `here <https://github.com/Delitefully/DiscordLists?tab=readme-ov-file#guild-feature-glossary>`_."
+msgstr "A list of features that the guild has. The features that a guild can have are subject to arbitrary change by Discord. You can find a catalog of guild features `here <https://github.com/Delitefully/DiscordLists?tab=readme-ov-file#guild-feature-glossary>`_."
 
 msgid "List[:class:`str`]"
 msgstr "List[:class:`str`]"
@@ -7801,4 +7801,3 @@ msgstr "These are typically given for channel follower webhooks."
 
 msgid "Represents a partial channel for webhooks."
 msgstr "Represents a partial channel for webhooks."
-

docs/locales/es/LC_MESSAGES/api/models.po

@@ -1727,8 +1727,8 @@ msgstr "The guild's notification settings."
 msgid ":class:`NotificationLevel`"
 msgstr ":class:`NotificationLevel`"
 
-msgid "A list of features that the guild has. The features that a guild can have are subject to arbitrary change by Discord. You can find a catalog of guild features `here <https://github.com/Delitefully/DiscordLists#guild-feature-glossary>`_."
-msgstr "A list of features that the guild has. The features that a guild can have are subject to arbitrary change by Discord. You can find a catalog of guild features `here <https://github.com/Delitefully/DiscordLists#guild-feature-glossary>`_."
+msgid "A list of features that the guild has. The features that a guild can have are subject to arbitrary change by Discord. You can find a catalog of guild features `here <https://github.com/Delitefully/DiscordLists?tab=readme-ov-file#guild-feature-glossary>`_."
+msgstr "A list of features that the guild has. The features that a guild can have are subject to arbitrary change by Discord. You can find a catalog of guild features `here <https://github.com/Delitefully/DiscordLists?tab=readme-ov-file#guild-feature-glossary>`_."
 
 msgid "List[:class:`str`]"
 msgstr "List[:class:`str`]"
@@ -7801,4 +7801,3 @@ msgstr "These are typically given for channel follower webhooks."
 
 msgid "Represents a partial channel for webhooks."
 msgstr "Represents a partial channel for webhooks."
-

docs/locales/fr/LC_MESSAGES/api/models.po

@@ -1727,8 +1727,8 @@ msgstr "The guild's notification settings."
 msgid ":class:`NotificationLevel`"
 msgstr ":class:`NotificationLevel`"
 
-msgid "A list of features that the guild has. The features that a guild can have are subject to arbitrary change by Discord. You can find a catalog of guild features `here <https://github.com/Delitefully/DiscordLists#guild-feature-glossary>`_."
-msgstr "A list of features that the guild has. The features that a guild can have are subject to arbitrary change by Discord. You can find a catalog of guild features `here <https://github.com/Delitefully/DiscordLists#guild-feature-glossary>`_."
+msgid "A list of features that the guild has. The features that a guild can have are subject to arbitrary change by Discord. You can find a catalog of guild features `here <https://github.com/Delitefully/DiscordLists?tab=readme-ov-file#guild-feature-glossary>`_."
+msgstr "A list of features that the guild has. The features that a guild can have are subject to arbitrary change by Discord. You can find a catalog of guild features `here <https://github.com/Delitefully/DiscordLists?tab=readme-ov-file#guild-feature-glossary>`_."
 
 msgid "List[:class:`str`]"
 msgstr "List[:class:`str`]"
@@ -7801,4 +7801,3 @@ msgstr "These are typically given for channel follower webhooks."
 
 msgid "Represents a partial channel for webhooks."
 msgstr "Represents a partial channel for webhooks."
-

docs/locales/hi/LC_MESSAGES/api/models.po

@@ -1727,8 +1727,8 @@ msgstr "The guild's notification settings."
 msgid ":class:`NotificationLevel`"
 msgstr ":class:`NotificationLevel`"
 
-msgid "A list of features that the guild has. The features that a guild can have are subject to arbitrary change by Discord. You can find a catalog of guild features `here <https://github.com/Delitefully/DiscordLists#guild-feature-glossary>`_."
-msgstr "A list of features that the guild has. The features that a guild can have are subject to arbitrary change by Discord. You can find a catalog of guild features `here <https://github.com/Delitefully/DiscordLists#guild-feature-glossary>`_."
+msgid "A list of features that the guild has. The features that a guild can have are subject to arbitrary change by Discord. You can find a catalog of guild features `here <https://github.com/Delitefully/DiscordLists?tab=readme-ov-file#guild-feature-glossary>`_."
+msgstr "A list of features that the guild has. The features that a guild can have are subject to arbitrary change by Discord. You can find a catalog of guild features `here <https://github.com/Delitefully/DiscordLists?tab=readme-ov-file#guild-feature-glossary>`_."
 
 msgid "List[:class:`str`]"
 msgstr "List[:class:`str`]"
@@ -7801,4 +7801,3 @@ msgstr "These are typically given for channel follower webhooks."
 
 msgid "Represents a partial channel for webhooks."
 msgstr "Represents a partial channel for webhooks."
-