docs: use `eslint-doc-generator`

[Michaël De Boey]

@bmish created this awesome library that brings a unified way of rule docs
https://github.com/bmish/eslint-doc-generator

[Yosuke Ota]

I think that library is worth a try.
However, we configure the script to automatically mark the release version of the rules, so it may be difficult to use that library.

e.g. 8cffced#diff-a94087d993ec67e6fceedea0f6b9469c1cef47877617a79bd80c3f1d21a12094R6

[Bryan Mishkin]

However, we configure the script to automatically mark the release version of the rules, so it may be difficult to use that library.

eslint-doc-generator doesn't manage the entire rule doc so I think that's fine and not an issue.

However, I looked into adding eslint-doc-generator to this plugin and found several blockers due to the use of the static site generator:

• bmish/eslint-doc-generator#252
• bmish/eslint-doc-generator#253
• bmish/eslint-doc-generator#254

[Bryan Mishkin]

I've addressed all those blockers and opened #493.