docs: Adjust documentation, fix typos, update locale.

README.rst

@@ -1,32 +1,19 @@
-===============
 interactions.py
 ===============
 
 **Easy, simple, scalable and modular: a Python API wrapper for interactions.**
 
 .. image:: https://img.shields.io/pypi/dm/discord-py-slash-command.svg
-    :target: https://pypi.python.org/pypi/discord-py-interactions/
-    :alt: PyPI Monthly Downloads
 
 .. image:: https://img.shields.io/github/license/goverfl0w/discord-interactions.svg
-    :target: https://github.com/goverfl0w/discord-interactions/blob/master/LICENSE
-    :alt: License
 
 .. image:: https://img.shields.io/pypi/pyversions/discord-py-interactions.svg
-    :target: https://pypi.python.org/pypi/discord-py-interactions/
-    :alt: PyPI Versions
 
 .. image:: https://img.shields.io/pypi/v/discord-py-interactions.svg
-    :target: https://pypi.python.org/pypi/discord-py-interactions/
-    :alt: PyPI Version
 
 .. image:: https://readthedocs.org/projects/discord-interactions/badge/?version=latest
-    :target: http://discord-interactions.readthedocs.io/?badge=latest
-    :alt: Documentation Status
 
 .. image:: https://discord.com/api/guilds/789032594456576001/embed.png
-    :target: https://discord.gg/KkgMBVuEkx
-    :alt: Discord
 
 ----
 

docs/api.gateway.rst

@@ -6,3 +6,11 @@ Gateway
 .. automodule:: interactions.api.gateway
     :members:
     :noindex:
+
+.. automodule:: interactions.api.gateway.client
+    :members:
+    :noindex:
+
+.. automodule:: interactions.api.gateway.heartbeat
+    :members:
+    :noindex:

docs/api.http.rst

@@ -19,50 +19,50 @@ HTTP
     :members:
     :noindex:
 
-.. autoclass:: interactions.api.http.channel._ChannelRequest
+.. autoclass:: interactions.api.http.channel.ChannelRequest
     :members:
     :noindex:
 
-.. autoclass:: interactions.api.http.emoji._EmojiRequest
+.. autoclass:: interactions.api.http.emoji.EmojiRequest
     :members:
     :noindex:
 
-.. autoclass:: interactions.api.http.guild._GuildRequest
+.. autoclass:: interactions.api.http.guild.GuildRequest
     :members:
     :noindex:
 
-.. autoclass:: interactions.api.http.interaction._InteractionRequest
+.. autoclass:: interactions.api.http.interaction.InteractionRequest
     :members:
     :noindex:
 
-.. autoclass:: interactions.api.http.member._MemberRequest
+.. autoclass:: interactions.api.http.member.MemberRequest
     :members:
     :noindex:
 
-.. autoclass:: interactions.api.http.message._MessageRequest
+.. autoclass:: interactions.api.http.message.MessageRequest
     :members:
     :noindex:
 
-.. autoclass:: interactions.api.http.reaction._ReactionRequest
+.. autoclass:: interactions.api.http.reaction.ReactionRequest
     :members:
     :noindex:
 
-.. autoclass:: interactions.api.http.scheduledEvent._ScheduledEventRequest
+.. autoclass:: interactions.api.http.scheduledEvent.ScheduledEventRequest
     :members:
     :noindex:
 
-.. autoclass:: interactions.api.http.sticker._StickerRequest
+.. autoclass:: interactions.api.http.sticker.StickerRequest
     :members:
     :noindex:
 
-.. autoclass:: interactions.api.http.thread._ThreadRequest
+.. autoclass:: interactions.api.http.thread.ThreadRequest
     :members:
     :noindex:
 
-.. autoclass:: interactions.api.http.user._UserRequest
+.. autoclass:: interactions.api.http.user.UserRequest
     :members:
     :noindex:
 
-.. autoclass:: interactions.api.http.webhook._WebhookRequest
+.. autoclass:: interactions.api.http.webhook.WebhookRequest
     :members:
     :noindex:

docs/client.rst

@@ -3,6 +3,6 @@
 Bot Client
 ==========
 
-.. automodule:: interactions.client
+.. automodule:: interactions.client.bot
     :members:
     :noindex:

docs/conf.py

@@ -39,6 +39,7 @@
     "sphinx.ext.autosectionlabel",
     "hoverxref.extension",
     "karma_sphinx_theme",
+    "sphinx_search.extension",
 ]
 
 # Stackoverflow said that this is gonna cure my LaTeX errors for ref handling.
@@ -57,7 +58,11 @@
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = "de"
+
+# Language is commented out because of PR reviews. In a RTD-hosted case,
+# the variable seems to be skipped.
+# language = "de"
+
 locale_dirs = ["locale/"]
 gettext_compact = True
 
@@ -66,8 +71,9 @@
 # This pattern also affects html_static_path and html_extra_path.
 exclude_patterns = ["_build"]
 
-# This should fix wrong sort
-autodoc_member_order = "bysource"
+# This autodocs private attrs and also fixes wrong sort
+autodoc_default_options = {"member-order": "bysource", "private-members": True}
+
 
 # -- Options for HTML output -------------------------------------------------
 

docs/context.rst

@@ -3,6 +3,7 @@
 Event Context
 =============
 
-.. automodule:: interactions.context
+.. automodule:: interactions.client.context
     :members:
+    :inherited-members:
     :noindex:

docs/enums.rst

@@ -3,6 +3,6 @@
 Enumerable Objects
 ==================
 
-.. automodule:: interactions.enums
+.. automodule:: interactions.client.enums
     :members:
     :noindex:

docs/index.rst

@@ -26,7 +26,7 @@ Some more unique features that are exclusive to our interactions include:
 - **Event-triggered callbacks**: whether a component, application command or interaction response, you'll never need to worry about bridging responses.
 - **Dual-way decorator logic**: a decorator can act as both a constructor for an interaction, as well as a callback.
 - **API-strict naming**: no more confusion with the naming approach of many libraries; we follow the naming style of interactions from the officially curated Discord Developers documentation.
-- **Extensive framework structure**: (**pending in** ``4.1.0``) build your own tools and technologies for our library to develop and integrate community creations.
+- **Extensive framework structure**: build your own tools and technologies for our library to develop and integrate community creations.
 
 What do we not offer?
 *********************
@@ -88,7 +88,7 @@ Advanced Search
 * :ref:`modindex`
 * :ref:`search`
 
-.. _contribution requirements: https://github.com/interactions-py/library/blob/stable/CONTRIBUTING.md
+.. _contribution requirements: https://github.com/interactions-py/library/blob/stable/CONTRIBUTING.rst
 .. _MIT License: https://github.com/interactions-py/library/blob/stable/LICENSE
 .. _Pull Requests: https://github.com/interactions-py/library/pulls
 .. _Issues: https://github.com/interactions-py/library/issues