diff --git a/README.md b/README.md
index 4733fb6..41829c7 100644
--- a/README.md
+++ b/README.md
@@ -52,9 +52,9 @@ Rule 'rule-to-never-disable' should not be disabled. Explanation for why this is
 <!-- prettier-ignore-start -->
 <!-- begin auto-generated rules list -->
 
-| Name                                 | Description                               |
-| :----------------------------------- | :---------------------------------------- |
-| [rulesRule](docs/rules/rulesRule.md) | Completely bans disabling specific rules. |
+| Name                         | Description                               |
+| :--------------------------- | :---------------------------------------- |
+| [rules](docs/rules/rules.md) | Completely bans disabling specific rules. |
 
 <!-- end auto-generated rules list -->
 <!-- prettier-ignore-end -->
diff --git a/docs/rules/rules.md b/docs/rules/rules.md
index 1777dd7..edab96c 100644
--- a/docs/rules/rules.md
+++ b/docs/rules/rules.md
@@ -44,10 +44,10 @@ Rules may be specified as an array of objects, each of which have the following
 
 <!-- begin auto-generated rule options list -->
 
-| Name      | Type     |
-| :-------- | :------- |
-| `message` | String   |
-| `rule`    | String   |
-| `rules`   | Object[] |
+| Name      | Description                             | Type     |
+| :-------- | :-------------------------------------- | :------- |
+| `message` | Message to include in rule reports.     | String   |
+| `rule`    | Rule to disable, including plugin name. | String   |
+| `rules`   |                                         | Object[] |
 
 <!-- end auto-generated rule options list -->