[Docs] Fix driver docs showing twice (#3035)

* docs(config): fix doubled docs for drivers

* enhance(drivers): add docstrings to enums that show in docs

* chore(changelog): add towncrier entries

changelog.d/2972.docs.rst

@@ -0,0 +1 @@
+Driver docs no longer show twice.

changelog.d/3035.docs.rst

@@ -0,0 +1 @@
+Add proper docstrings to enums that show in drivers docs.

docs/framework_config.rst

@@ -443,7 +443,12 @@ Value
 Driver Reference
 ****************
 
-.. automodule:: redbot.core.drivers
+.. autofunction:: redbot.core.drivers.get_driver
+
+.. autoclass:: redbot.core.drivers.BackendType
+    :members:
+
+.. autoclass:: redbot.core.drivers.ConfigCategory
     :members:
 
 Base Driver
@@ -456,3 +461,7 @@ JSON Driver
 .. autoclass:: redbot.core.drivers.JsonDriver
     :members:
 
+Postgres Driver
+^^^^^^^^^^^^^^^
+.. autoclass:: redbot.core.drivers.PostgresDriver
+    :members:

redbot/core/drivers/__init__.py

@@ -18,9 +18,13 @@ __all__ = [
 
 
 class BackendType(enum.Enum):
+    """Represents storage backend type."""
+
+    #: JSON storage backend.
     JSON = "JSON"
+    #: Postgres storage backend.
     POSTGRES = "Postgres"
-    # Dead drivrs below retained for error handling.
+    # Dead drivers below retained for error handling.
     MONGOV1 = "MongoDB"
     MONGO = "MongoDBV2"
 

redbot/core/drivers/base.py

@@ -6,11 +6,19 @@ __all__ = ["BaseDriver", "IdentifierData", "ConfigCategory"]
 
 
 class ConfigCategory(str, enum.Enum):
+    """Represents config category."""
+
+    #: Global category.
     GLOBAL = "GLOBAL"
+    #: Guild category.
     GUILD = "GUILD"
+    #: Channel category.
     CHANNEL = "TEXTCHANNEL"
+    #: Role category.
     ROLE = "ROLE"
+    #: User category.
     USER = "USER"
+    #: Member category.
     MEMBER = "MEMBER"
 
     @classmethod