docs: clarify kinds of lint rules in formatting docs

[JoshuaKGoldberg]

PR Checklist

• Addresses an existing open issue: fixes Docs: Be more clear in differentiating "formatting" vs "style" #6495
  • Also relevant: Suggestion: Be more clear in differentiating "formatting" vs "style" eslint/eslint.org#419
• That issue was marked as accepting prs
• Steps in Contributing were taken

Overview

Applies a few changes to make the page more friendly for newcomers:

• Moves the ESLint Core and Formatting section to the end, so that folks start with the more-relevant explanation of Formatters vs. Linters
• Adds an explanation of the 2-3 categories of lint rules at the start of ESLint Core and Formatting
• Elaborates on why you'd want to use eslint-config-prettier, as you don't actually need it unless you enable rules separate from the core/typescript-eslint recommended presets

cc @mattpocock @nzakas for interest 👋

[typescript-eslint]

Thanks for the PR, @JoshuaKGoldberg!

typescript-eslint is a 100% community driven project, and we are incredibly grateful that you are contributing to that community.

The core maintainers work on this in their personal time, so please understand that it may not be possible for them to review your work immediately.

Thanks again!

---

🙏 Please, if you or your company is finding typescript-eslint valuable, help us sustain the project by sponsoring it transparently on https://opencollective.com/typescript-eslint.

[nx-cloud]

☁️ Nx Cloud Report

CI is running/has finished running commands for commit 8b8b644. As they complete they will appear below. Click to see the status, the terminal output, and the build insights.

📂 See all runs for this branch

---

✅ Successfully ran 46 targets

• Node 18 - nx test eslint-plugin
• Node 14 - nx test eslint-plugin --coverage=false
• Node 18 - nx test utils
• Node 18 - nx run-many --target=build --parallel --exclude website
• Node 18 - nx test ast-spec
• Node 18 - nx run-many --target=build --parallel --exclude website
• nx run-many --target=build --parallel --exclude website
• Node 18 - nx test eslint-plugin-internal
• Node 18 - nx test eslint-plugin-tslint
• Node 18 - nx run-many --target=build --parallel --exclude website
• Node 18 - nx run-many --target=build --parallel --exclude website
• Node 18 - nx run-many --target=build --parallel --exclude website
• Node 14 - nx test typescript-estree --coverage=false
• Node 18 - nx test type-utils
• Node 18 - nx run-many --target=build --parallel --exclude website
• nx run-many --target=typecheck --parallel
• Node 18 - nx test visitor-keys
• Node 18 - nx run-many --target=build --parallel --exclude website
• Node 14 - nx test type-utils --coverage=false
• Node 14 - nx run-many --target=build --parallel --exclude website
• Node 14 - nx test utils --coverage=false
• Node 14 - nx run-many --target=build --parallel --exclude website
• Node 14 - nx test eslint-plugin-internal --coverage=false
• Node 14 - nx test scope-manager --coverage=false
• Node 14 - nx run-many --target=build --parallel --exclude website
• Node 18 - nx test parser
• Node 18 - nx run-many --target=build --parallel --exclude website
• Node 14 - nx run-many --target=build --parallel --exclude website
• Node 14 - nx test visitor-keys --coverage=false
• nx run-many --target=build --parallel --exclude website
• Node 18 - nx test scope-manager
• Node 14 - nx run-many --target=build --parallel --exclude website
• nx run-many --target=lint --parallel
• Node 18 - nx run-many --target=build --parallel --exclude website
• nx run-many --target=build --parallel --exclude website
• Node 14 - nx run-many --target=build --parallel --exclude website
• Node 18 - nx test typescript-estree
• Node 14 - nx run-many --target=build --parallel --exclude website
• Node 18 - nx run-many --target=build --parallel --exclude website
• Node 14 - nx test eslint-plugin-tslint --coverage=false
• Node 14 - nx test ast-spec --coverage=false
• Node 14 - nx test parser --coverage=false
• Node 14 - nx run-many --target=build --parallel --exclude website
• Node 14 - nx run-many --target=build --parallel --exclude website
• Node 14 - nx run-many --target=build --parallel --exclude website
• nx run-many --target=build --parallel --exclude website

---

Sent with 💌 from NxCloud.

[netlify]

✅ Deploy Preview for typescript-eslint ready!

Name	Link
🔨 Latest commit	8b8b644
🔍 Latest deploy log	https://app.netlify.com/sites/typescript-eslint/deploys/63f635727657ce0008facc0a
😎 Deploy Preview	https://deploy-preview-6510--typescript-eslint.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site settings.

[rubiesonthesky]

I feel weird mentioning semicolons as just formatting, because they can affect runtime behavior. 😅 The decision between using them only where needed and always, is stylistic. Of course this is nit and it may be clear for everyone what is meant here.

[Josh-Cena]

I feel weird mentioning semicolons as just formatting, because they can affect runtime behavior.

It doesn't change runtime behavior; it changes how the code parses altogether. I guess when we say "change semicolons" it's really implied that we are changing it in a syntactically insignificant way.