Doc corrections

Author: Taaku18

cogs/modmail.py

@@ -1,5 +1,4 @@
 import asyncio
-import re
 import os
 from datetime import datetime
 from typing import Optional, Union
@@ -177,7 +176,7 @@ async def snippets_remove(self, ctx, *, name: str.lower):
     @checks.thread_only()
     async def move(self, ctx, *, category: discord.CategoryChannel):
         """
-        Move a thread to a specified category.
+        Move a thread to another category.
 
         `category` may be a category ID, mention, or name.
         """
@@ -268,12 +267,13 @@ async def close(self, ctx, *, after: UserFriendlyTime = None):
     @checks.thread_only()
     async def notify(self, ctx, *, role: Union[discord.Role, str.lower, None] = None):
         """
-        Notify a role or yourself to the next thread message received.
+        Notify a role or yourself when the next thread message received.
 
-        Once a thread message is received `role` will only be pinged once.
+        Once a thread message is received, `role` will only be pinged once.
 
-        Leave `role` empty to notify yourself. `@here` and `@everyone` can be substituted with `here` and `everyone`.
-        `role` may be a role ID, mention, or name.
+        Leave `role` empty to notify yourself.
+        `@here` and `@everyone` can be substituted with `here` and `everyone`.
+        `role` may be a role ID, mention, name, "everyone", or "here".
         """
         thread = ctx.thread
 
@@ -312,8 +312,9 @@ async def subscribe(self, ctx, *, role: Union[discord.Role, str.lower, None] = N
 
         You will be pinged for every thread message received until you unsubscribe.
 
-        Leave `role` empty to notify yourself. `@here` and `@everyone` can be substituted with `here` and `everyone`.
-        `role` may be a role ID, mention, or name.
+        Leave `role` empty to subscribe yourself.
+        `@here` and `@everyone` can be substituted with `here` and `everyone`.
+        `role` may be a role ID, mention, name, "everyone", or "here".
         """
         thread = ctx.thread
 
@@ -350,10 +351,11 @@ async def subscribe(self, ctx, *, role: Union[discord.Role, str.lower, None] = N
     @checks.thread_only()
     async def unsubscribe(self, ctx, *, role=None):
         """
-        Unsubscribe a role yourself from a thread.
+        Unsubscribe a role or yourself from a thread.
 
-        Leave `role` empty to notify yourself. `@here` and `@everyone` can be substituted with `here` and `everyone`.
-        `role` may be a role ID, mention, or name.
+        Leave `role` empty to unsubscribe yourself.
+        `@here` and `@everyone` can be substituted with `here` and `everyone`.
+        `role` may be a role ID, mention, name, "everyone", or "here".
         """
         thread = ctx.thread
 
@@ -492,7 +494,7 @@ async def logs_closed_by(self, ctx, *, user: User = None):
         """
         Get all logs closed by the specified user.
 
-        If no `user` is provided, the user will be whoever sent this command.
+        If no `user` is provided, the user will be the person who sent this command.
         `user` may be a user ID, mention, or name.
         """
         user = user if user is not None else ctx.author
@@ -740,7 +742,7 @@ async def block(self, ctx, user: Optional[User] = None, *,
         """
         Block a user from using Modmail.
 
-        You may chose to set a time as to when the user will automatically be unblocked.
+        You may choose to set a time as to when the user will automatically be unblocked.
 
         Leave `user` blank when this command is used within a
         thread channel to block the current recipient.

cogs/utility.py

@@ -11,7 +11,7 @@
 from pkg_resources import parse_version
 from textwrap import indent
 
-from discord import Embed, Color, Activity, Role, Member
+from discord import Embed, Color, Activity, Role
 from discord.enums import ActivityType, Status
 from discord.ext import commands
 
@@ -287,7 +287,7 @@ async def debug(self, ctx):
     @checks.has_permissions(PermissionLevel.OWNER)
     @trigger_typing
     async def debug_hastebin(self, ctx):
-        """Stores application-logs to Hastebin."""
+        """Posts application-logs to Hastebin."""
 
         haste_url = os.environ.get('HASTE_URL', 'https://hasteb.in')
 
@@ -353,7 +353,7 @@ async def github(self, ctx):
     @trigger_typing
     async def update(self, ctx, *, flag: str = ''):
         """
-        Update bot.
+        Update Modmail.
 
         This only works for Heroku users who have configured their bot for updates.
 
@@ -1015,7 +1015,7 @@ async def permissions_add_level(self, ctx, level: str, *,
                        invoke_without_command=True)
     @checks.has_permissions(PermissionLevel.OWNER)
     async def permissions_remove(self, ctx):
-        """Remove a permission to use a command or permission level."""
+        """Remove permission to use a command or permission level."""
         await ctx.send_help(ctx.command)
 
     @permissions_remove.command(name='command')