docstring semantics

redbot/core/core_commands.py

@@ -1380,7 +1380,7 @@ class Core(commands.commands._RuleDropper, commands.Cog, CoreLogic):
     async def load(self, ctx: commands.Context, *cogs: str):
         """Loads packages from the local paths and installed cogs.
 
-        See available packages with `[p]cogs`.
+        See packages available to load with `[p]cogs`.
 
         Examples:
             - `[p]load general` - Loads the `general` cog.
@@ -1500,7 +1500,17 @@ class Core(commands.commands._RuleDropper, commands.Cog, CoreLogic):
     @commands.command()
     @checks.is_owner()
     async def unload(self, ctx: commands.Context, *cogs: str):
-        """Unloads packages."""
+        """Unloads packages.
+
+        See packages available to unload with `[p]cogs`.
+
+        Examples:
+            - `[p]load general` - Loads the `general` cog.
+            - `[p]load admin mod mutes` - Loads multiple cogs.
+
+        **Arguments:**
+
+        - `[cogs...]` Required to set to public. Not required to toggle back to private."""
         if not cogs:
             return await ctx.send_help()
         cogs = tuple(map(lambda cog: cog.rstrip(","), cogs))