Before You File a Documentation Request Please Confirm You Have Done The Following...

• I have looked for existingopen or closed documentation requests that match my proposal.
• I haveread the FAQ and my problem is not listed.

Suggested Changes

Last year,@ElianCodes led me through a pairing to audit the site's docs. See time ~24:45 on inhttps://youtu.be/Vyu8FU0VAqA?si=q8JeWxGYauNqDIMa&t=1482. It was super informative and showed a lot of IMO great improvement opportunities we could go for on, just to start, the homepage:

• "The tooling that enables ESLint and Prettier to support TypeScript.": This is technically true but not compelling.
  • We do much more than this! We provide typed linting infrastructure and -most relevantly to what most users care about- a lot of TypeScript-specific rules
  • A nontrivial percentage of our audience already knows what ESLint + TypeScript + Prettier are. Spending multiple vertical screens of explanation over-optimizes for newcomers.
• "Prettier": this note is really more about social proof /"used by", most users don't care about the implementation detail of our AST plumbing used by them
• "Why does this project exist?": The “compare” isn’t actually there - we state the two tools, but not an explicit comparison. We never answer the question!
• Financial Contributors: the docs link isn't very clear, and doesn't have a lot of supporting explanation of why you'd want to.
• Get Started buttons: the same text appears 3 times. Consider having more variety / wording of call-to-actions.

I'd like to revamp the homepage to address these audit notes.

Affected URL(s)

https://typescript-eslint.io

Additional Info

💖

Co-authored-by:@ElianCodes