Improve linter rules documentation

[shulaoda]

Description

We have currently adopted a new document template, and some rules need to be supplemented and aligned again.

/// ### What it does
///
/// ### Why is this bad?
///
/// ### Examples
///
/// Examples of **incorrect** code for this rule:
///
/// Examples of **correct** code for this rule:

Currently, some known rules have the following issues:

• Missing Why is this bad?
• Examples are not in the latest format.

Task lists

• [ ] rules/eslint
• [x] rules/import
• [ ] rules/jest
• [x] rules/jsdoc
• [ ] rules/jsx_a11y
• [ ] rules/nextjs
• [x] rules/node
• [ ] rules/oxc
• [x] rules/promise
• [ ] rules/react
• [x] rules/react_perf
• [x] rules/security
• [ ] rules/typescript
• [ ] rules/unicorn
• [x] rules/vitest

[DonIsaac]

@shulaoda is this a comprehensive list or are there more areas you want to document?

[shulaoda]

@shulaoda is this a comprehensive list or are there more areas you want to document?

This is not comprehensive, I will gradually supplement it. I will list the areas involved later.

[DonIsaac]

@shulaoda I don't love having a running issue like this open without clear goals, so I'm going to close this as complete. When you find other areas you want to document, feel free to open a new issue with those areas listed in the description.

[shulaoda]

@shulaoda I don't love having a running issue like this open without clear goals, so I'm going to close this as complete. When you find other areas you want to document, feel free to open a new issue with those areas listed in the description.

Apologies for that, my bad. I should have provided a clear description from the beginning. Could you reopened the issue?