Hi @TheSisb!

So, resources we do have on this topic are

• this blog post
• filtered rule list based on rules requiring type info

Would you feel that those resources cover the topic thoroughly? And if so do you think linking them on https://typescript-eslint.io/getting-started/typed-linting/ would be sufficient? Or, if not, curious if you have something else in mind. Let us know! Thanks!

It's a little hard to quantify this though.

The benefits depend on what rules you choose to enable. Additionally the value of each rule is entirely subjective - some people think that the rules are immensely valuable and they think they're worth it, no matter the cost, and others think the opposite.

Its really up to you as the user to determine if that cost is worth it by browsing the rules to see if anything looks valuable to you.
Or better yet, turn on the recommended config and do a lint run against your codebase to see what problems it finds.

Really the best advice is "we recommend it - but you should try it and decide for yourself" - which is exactly the advice at the end of the section:

We strongly recommend you do use type-aware linting, but the above information is included so that you can make your own, informed decision.

I think this actually ties strongly into #11184. As in, I think the root of this issue is:

1. If you don't understand the difference between linting and type checking, most of our website will be confusing in this way
2. The homepage currently is where we try to answer similar questions:

• "What are ESLint and TypeScript, and how do they compare?"
• "Why does this project exist?"

3. The homepage currently does not actually explain the difference between linting & type checking

My vote is to close this issue as a duplicate of #11184. As in, I'm in support of better answering this question, and would like to do that by overhauling the homepage.

Hi @TheSisb!

So, resources we do have on this topic are

• this blog post
• filtered rule list based on rules requiring type info

Would you feel that those resources cover the topic thoroughly? And if so do you think linking them on https://typescript-eslint.io/getting-started/typed-linting/ would be sufficient? Or, if not, curious if you have something else in mind. Let us know! Thanks!

Those resources linked from that page would indeed be valuable, as they answered my question perfectly. I didn't consider checking the blog, so thank you

Awesome! Closing as covered-by / duplicate / subset of #11184. Cheers!