From 23997d7a71db62f8273833f68b7d0627b391b591 Mon Sep 17 00:00:00 2001
From: Kreusada <67752638+Kreusada@users.noreply.github.com>
Date: Wed, 26 May 2021 18:30:23 +0100
Subject: [PATCH] [Docs] Modlog Cog Guide (#4919)

* Initial commit

* Docstring changes and index

* Add modlog cog guide to labeler
---
 .github/labeler.yml          |   1 +
 docs/cog_guides/modlog.rst   | 191 +++++++++++++++++++++++++++++++++++
 docs/index.rst               |   1 +
 redbot/cogs/modlog/modlog.py |   2 +-
 4 files changed, 194 insertions(+), 1 deletion(-)
 create mode 100644 docs/cog_guides/modlog.rst

diff --git a/.github/labeler.yml b/.github/labeler.yml
index ce91d15ab..720d0adfe 100644
--- a/.github/labeler.yml
+++ b/.github/labeler.yml
@@ -131,6 +131,7 @@
   - redbot/core/modlog.py
   # Docs
   - docs/framework_modlog.rst
+  - docs/cog_guides/modlog.rst
 "Category: Modlog Cog":
   - redbot/cogs/modlog/*
 "Category: Mutes Cog":
diff --git a/docs/cog_guides/modlog.rst b/docs/cog_guides/modlog.rst
new file mode 100644
index 000000000..29f6faad4
--- /dev/null
+++ b/docs/cog_guides/modlog.rst
@@ -0,0 +1,191 @@
+.. _modlog:
+
+======
+ModLog
+======
+
+This is the cog guide for the modlog cog. You will
+find detailed docs about usage and commands.
+
+``[p]`` is considered as your prefix.
+
+.. note:: To use this cog, load it by typing this::
+
+        [p]load modlog
+
+.. _modlog-usage:
+
+-----
+Usage
+-----
+
+Manage log channels for moderation actions.
+
+
+.. _modlog-commands:
+
+--------
+Commands
+--------
+
+.. _modlog-command-case:
+
+^^^^
+case
+^^^^
+
+**Syntax**
+
+.. code-block:: none
+
+    [p]case <number>
+
+**Description**
+
+Show the specified case.
+
+**Arguments**
+
+* ``<case>``: The case number to get information for.
+
+.. _modlog-command-casesfor:
+
+^^^^^^^^
+casesfor
+^^^^^^^^
+
+**Syntax**
+
+.. code-block:: none
+
+    [p]casesfor <member>
+
+**Description**
+
+Display cases for the specified member.
+
+**Arguments**
+
+* ``<member>``: The member to get cases for. |member-input|
+
+.. _modlog-command-listcases:
+
+^^^^^^^^^
+listcases
+^^^^^^^^^
+
+**Syntax**
+
+.. code-block:: none
+
+    [p]listcases <member>
+
+**Description**
+
+List cases for the specified member.
+
+**Arguments**
+
+* ``<member>``: The member to get cases for. |member-input|
+
+.. _modlog-command-modlogset:
+
+^^^^^^^^^
+modlogset
+^^^^^^^^^
+
+.. note:: |guildowner-lock|
+
+**Syntax**
+
+.. code-block:: none
+
+    [p]modlogset 
+
+**Description**
+
+Manage modlog settings.
+
+.. _modlog-command-modlogset-cases:
+
+"""""""""""""""
+modlogset cases
+"""""""""""""""
+
+**Syntax**
+
+.. code-block:: none
+
+    [p]modlogset cases [action]
+
+**Description**
+
+Enable or disable case creation for a mod action.
+
+**Arguments**
+
+* ``[action]``: The action to enable or disable case creation for.
+
+.. _modlog-command-modlogset-modlog:
+
+""""""""""""""""
+modlogset modlog
+""""""""""""""""
+
+**Syntax**
+
+.. code-block:: none
+
+    [p]modlogset modlog [channel]
+
+.. tip:: Alias: ``modlogset channel``
+
+**Description**
+
+Set a channel as the modlog.
+
+**Arguments**
+
+* ``[channel]``: The channel to set as the modlog. If omitted, the modlog will be disabled.
+
+.. _modlog-command-modlogset-resetcases:
+
+""""""""""""""""""""
+modlogset resetcases
+""""""""""""""""""""
+
+**Syntax**
+
+.. code-block:: none
+
+    [p]modlogset resetcases 
+
+**Description**
+
+Reset all modlog cases in this server.
+
+.. _modlog-command-reason:
+
+^^^^^^
+reason
+^^^^^^
+
+**Syntax**
+
+.. code-block:: none
+
+    [p]reason [case] <reason>
+
+**Description**
+
+Specify a reason for a modlog case.
+
+Please note that you can only edit cases you are
+the owner of unless you are a mod, admin or server owner.
+
+**Arguments**
+
+* ``[case]``: The case number to update the reason for.
+* ``<reason>``: The new reason for the specified case.
+
+.. note:: If no case number is specified, the latest case will be used.
diff --git a/docs/index.rst b/docs/index.rst
index ecf85e9c5..fc2371958 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -45,6 +45,7 @@ Welcome to Red - Discord Bot's documentation!
     cog_guides/general
     cog_guides/image
     cog_guides/mod
+    cog_guides/modlog
     cog_guides/mutes
     cog_guides/reports
     cog_guides/streams
diff --git a/redbot/cogs/modlog/modlog.py b/redbot/cogs/modlog/modlog.py
index f5942e8b0..c7d7e5e90 100644
--- a/redbot/cogs/modlog/modlog.py
+++ b/redbot/cogs/modlog/modlog.py
@@ -45,7 +45,7 @@ class ModLog(commands.Cog):
     async def modlog(self, ctx: commands.Context, channel: discord.TextChannel = None):
         """Set a channel as the modlog.
 
-        Omit `<channel>` to disable the modlog.
+        Omit `[channel]` to disable the modlog.
         """
         guild = ctx.guild
         if channel: