Document good-bad examples and suggestions

[hyunbinseo]

Continuing the discussion from this thread:

Problem

regex based rules are hard to grasp by their name only. For example,

• digits is /^\d+$/ and does not allow -1.
• decimal is /^[+-]?\d+(?:\.\d+)?$/ and does allow -1.

I was surprised to find this, because I thought the latter required decimal point(s).

Suggestion

What if the documentation showed:

• good and bad examples like ESLint
• suggestions to use another API

Example

digits

show regex

/^\d+$/

✅ 3
❎ -3
❎ 3.0 // use decimal instead

[fabian-hiller]

Your idea is great. I will come back to this and other similar issues and PRs after V1 is available.