docs fixes, message attribute fix

Author: krittick

discord/ext/menus/pagination.py

@@ -77,12 +77,12 @@ class Paginator(discord.ui.View):
     user: Optional[Union[:class:`~discord.User`, :class:`~discord.Member`]]
         The user or member that invoked the Paginator.
     message: Union[:class:`~discord.Message`, :class:`~discord.WebhookMessage`]
-        The message sent from the Paginator.
+        The message the Paginator is attached to.
 
     Parameters
     ----------
     pages: Union[List[:class:`str`], List[:class:`discord.Embed`]]
-        Your list of strings or embeds to paginate
+        Your list of strings and/or embeds to paginate
     show_disabled: :class:`bool`
         Choose whether or not to show disabled buttons
     show_indicator: :class:`bool`
@@ -114,7 +114,7 @@ def __init__(
         self.show_indicator = show_indicator
         self.disable_on_timeout = disable_on_timeout
         self.custom_view = custom_view
-        self.message: Union[discord.Message, discord.WebhookMessage]
+        self.message: Union[discord.Message, discord.WebhookMessage, None] = None
         self.buttons = {
             "first": {
                 "object": PaginatorButton(
@@ -221,6 +221,7 @@ def customize_button(
         ----------
         button_name: :class:`str`
             Name of the button to customize
+            Must be one of ``first``, ``prev``, ``next``, or ``last``.
         button_label: :class:`str`
             Label to display on the button
         button_emoji:
@@ -248,7 +249,7 @@ def update_buttons(self) -> Dict:
         Returns
         -------
         Dict[:class:`str`, Dict[:class:`str`, Union[:class:`~PaginatorButton`, :class:`bool`]]]
-            The dictionary of buttons that was updated.
+            The dictionary of buttons that were updated.
         """
         for key, button in self.buttons.items():
             if key == "first":

docs/ext/menus/index.rst

@@ -18,7 +18,7 @@ A Basic Example Of `ext.menus` Being Used
     from discord.ext import commands, menus
 
 
-    class MenusExample(commands.Cog):
+    class PageTest(commands.Cog):
         def __init__(self, bot):
             self.bot = bot
 
@@ -34,8 +34,8 @@ A Basic Example Of `ext.menus` Being Used
         def get_pages(self):
             return self.pages
 
-        @slash_command(name="pageexample")
-        async def pageexample(self, ctx):
+        @slash_command(name="pagetest")
+        async def pagetest(self, ctx):
             await ctx.defer()
             pages = menus.Paginator(pages=self.get_pages(), show_disabled=False, show_indicator=True)
             pages.customize_button("next", button_label=">", button_style=discord.ButtonStyle.green)
@@ -44,8 +44,8 @@ A Basic Example Of `ext.menus` Being Used
             pages.customize_button("last", button_label=">>", button_style=discord.ButtonStyle.blurple)
             await pages.send(ctx, ephemeral=False)
 
-        @slash_command(name="pageexample_custom")
-        async def pageexample_custom(self, ctx):
+        @slash_command(name="pagetest_custom")
+        async def pagetest_custom(self, ctx):
             await ctx.defer()
             view = discord.ui.View()
             view.add_item(discord.ui.Button(label="Test Button, Does Nothing", row=1))
@@ -60,7 +60,7 @@ A Basic Example Of `ext.menus` Being Used
 
 
     def setup(bot):
-        bot.add_cog(MenusExample(bot))
+        bot.add_cog(PageTest(bot))
 
 .. _discord_ext_menus_api: