docs(eslint): move rule docs into eslint-rules directory

Co-authored-by: Kent C. Dodds <me+github@kentcdodds.com>

Author: cursoragent

README.md

@@ -139,33 +139,7 @@ configurations minimal and only enable rules that catch real problems (the kind
 that are likely to happen). This keeps our linting faster and reduces the number
 of false positives.
 
-#### `epic-web/no-manual-dispose`
-
-This config includes `epic-web/no-manual-dispose` as a warning to encourage
-`using` and `await using` for disposable resources.
-
-The rule warns on:
-
-- direct calls to `[Symbol.dispose]`, `[Symbol.asyncDispose]`, and
-  `[Symbol.disposeAsync]`
-- `.dispose()` (or `['dispose']()`) calls inside `finally` blocks
-
-Example warning:
-
-```js
-let tempFile
-try {
-	tempFile = createTempFile()
-} finally {
-	tempFile?.[Symbol.dispose]()
-}
-```
-
-Preferred:
-
-```js
-using tempFile = createTempFile()
-```
+Custom rule documentation lives in [`eslint-rules/index.md`](./eslint-rules/index.md).
 
 ### Oxlint
 

eslint-rules/index.md

@@ -0,0 +1,13 @@
+# ESLint rules
+
+Custom ESLint rules for this package live in this directory.
+
+Each rule should have:
+
+- implementation: `*.js`
+- tests: `*.test.js`
+- documentation: `*.md`
+
+## Rules
+
+- [`epic-web/no-manual-dispose`](./no-manual-dispose.md)

eslint-rules/no-manual-dispose.md

@@ -0,0 +1,54 @@
+# `epic-web/no-manual-dispose`
+
+Warns when disposable resources are cleaned up manually in patterns that should
+use `using` or `await using`.
+
+## Why
+
+Manual cleanup with `try/finally` and disposal calls is easier to get wrong and
+less readable than language-level disposables.
+
+## What it warns on
+
+- direct calls to `[Symbol.dispose]`
+- direct calls to `[Symbol.asyncDispose]`
+- direct calls to `[Symbol.disposeAsync]`
+- `.dispose()` and `['dispose']()` calls inside `finally` blocks
+
+## Examples
+
+### Invalid
+
+```js
+let tempFile
+try {
+	tempFile = createTempFile()
+} finally {
+	tempFile?.[Symbol.dispose]()
+}
+```
+
+```js
+let tempFile
+try {
+	tempFile = createTempFile()
+} finally {
+	tempFile?.dispose()
+}
+```
+
+### Valid
+
+```js
+using tempFile = createTempFile()
+```
+
+```js
+await using db = await createDisposableDatabase()
+```
+
+```js
+function cleanup(resource) {
+	resource.dispose()
+}
+```