docs: audit and revamp of main pages (#4112)

* docs: audit and revamp of main pages

* chore: add astexplorer, markdownlint to .cspell.json

* Apply suggestions from code review

Co-authored-by: Brad Zacher <[email protected]>

* chore: suggestions from code review

Co-authored-by: Brad Zacher <[email protected]>

Author: Josh Goldberg

.cspell.json

@@ -42,6 +42,7 @@
     "Airbnb's",
     "ambiently",
     "ASTs",
+    "astexplorer",
     "autofix",
     "autofixers",
     "autofixes",
@@ -68,6 +69,7 @@
     "IIFE",
     "IIFEs",
     "linebreaks",
+    "markdownlint",
     "necroing",
     "nocheck",
     "nullish",

.github/ISSUE_TEMPLATE.md

@@ -15,7 +15,7 @@ The more relevant information you can include, the faster we can find the issue
 
 - [ ] I have tried restarting my IDE and the issue persists.
 - [ ] I have updated to the latest version of the packages.
-- [ ] I have [read the FAQ](https://github.com/typescript-eslint/typescript-eslint/blob/master/docs/getting-started/linting/FAQ.md) and my problem is not listed.
+- [ ] I have [read the FAQ](https://github.com/typescript-eslint/typescript-eslint/blob/master/docs/getting-started/linting/TROUBLESHOOTING.md) and my problem is not listed.
 
 **Repro**
 

.github/ISSUE_TEMPLATE/config.yml

@@ -3,7 +3,7 @@ contact_links:
   -
     name: FAQ
     about: Please check out our FAQ before filing new issues
-    url: https://github.com/typescript-eslint/typescript-eslint/blob/master/docs/getting-started/linting/FAQ.md
+    url: https://github.com/typescript-eslint/typescript-eslint/blob/master/docs/getting-started/linting/TROUBLESHOOTING.md
   -
     name: Getting Started Guide
     about: If you're looking for help setting up check out our getting started guide

.github/ISSUE_TEMPLATE/eslint-plugin-tslint.md

@@ -23,7 +23,7 @@ If you have a problem with a specific lint rule, please back out and select the
 
 - [ ] I have tried restarting my IDE and the issue persists.
 - [ ] I have updated to the latest version of the packages.
-- [ ] I have [read the FAQ](https://github.com/typescript-eslint/typescript-eslint/blob/master/docs/getting-started/linting/FAQ.md) and my problem is not listed.
+- [ ] I have [read the FAQ](https://github.com/typescript-eslint/typescript-eslint/blob/master/docs/getting-started/linting/TROUBLESHOOTING.md) and my problem is not listed.
 
 **Repro**
 

.github/ISSUE_TEMPLATE/eslint-plugin-typescript.md

@@ -28,7 +28,7 @@ Are you opening an issue because the rule you're trying to use is not found?
 
 - [ ] I have tried restarting my IDE and the issue persists.
 - [ ] I have updated to the latest version of the packages.
-- [ ] I have [read the FAQ](https://github.com/typescript-eslint/typescript-eslint/blob/master/docs/getting-started/linting/FAQ.md) and my problem is not listed.
+- [ ] I have [read the FAQ](https://github.com/typescript-eslint/typescript-eslint/blob/master/docs/getting-started/linting/TROUBLESHOOTING.md) and my problem is not listed.
 
 **Repro**
 

.github/ISSUE_TEMPLATE/typescript-eslint-parser.md

@@ -24,7 +24,7 @@ If you have a problem with a specific lint rule, please back out and select the
 
 - [ ] I have tried restarting my IDE and the issue persists.
 - [ ] I have updated to the latest version of the packages.
-- [ ] I have [read the FAQ](https://github.com/typescript-eslint/typescript-eslint/blob/master/docs/getting-started/linting/FAQ.md) and my problem is not listed.
+- [ ] I have [read the FAQ](https://github.com/typescript-eslint/typescript-eslint/blob/master/docs/getting-started/linting/TROUBLESHOOTING.md) and my problem is not listed.
 
 **Repro**
 

.github/ISSUE_TEMPLATE/typescript-eslint-scope-manager.md

@@ -24,7 +24,7 @@ If you have a problem with the parser, please back out and select the `@typescri
 
 - [ ] I have tried restarting my IDE and the issue persists.
 - [ ] I have updated to the latest version of the packages.
-- [ ] I have [read the FAQ](https://github.com/typescript-eslint/typescript-eslint/blob/master/docs/getting-started/linting/FAQ.md) and my problem is not listed.
+- [ ] I have [read the FAQ](https://github.com/typescript-eslint/typescript-eslint/blob/master/docs/getting-started/linting/TROUBLESHOOTING.md) and my problem is not listed.
 
 **Repro**
 

.github/ISSUE_TEMPLATE/typescript-eslint-utils.md

@@ -24,7 +24,7 @@ If you have a problem with the parser, please back out and select the `@typescri
 
 - [ ] I have tried restarting my IDE and the issue persists.
 - [ ] I have updated to the latest version of the packages.
-- [ ] I have [read the FAQ](https://github.com/typescript-eslint/typescript-eslint/blob/master/docs/getting-started/linting/FAQ.md) and my problem is not listed.
+- [ ] I have [read the FAQ](https://github.com/typescript-eslint/typescript-eslint/blob/master/docs/getting-started/linting/TROUBLESHOOTING.md) and my problem is not listed.
 
 **Repro**
 

.github/ISSUE_TEMPLATE/typescript-estree.md

@@ -23,7 +23,7 @@ If you have a problem with a specific lint rule, please back out and select the
 
 - [ ] I have tried restarting my IDE and the issue persists.
 - [ ] I have updated to the latest version of the packages.
-- [ ] I have [read the FAQ](https://github.com/typescript-eslint/typescript-eslint/blob/master/docs/getting-started/linting/FAQ.md) and my problem is not listed.
+- [ ] I have [read the FAQ](https://github.com/typescript-eslint/typescript-eslint/blob/master/docs/getting-started/linting/TROUBLESHOOTING.md) and my problem is not listed.
 
 **Repro**