Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: add Troubleshooting page #18181

Merged
merged 13 commits into from Apr 4, 2024
Merged

Conversation

JoshuaKGoldberg
Copy link
Contributor

Prerequisites checklist

What is the purpose of this pull request? (put an "X" next to an item)

[x] Documentation update
[ ] Bug fix (template)
[ ] New rule (template)
[ ] Changes an existing rule (template)
[ ] Add autofix to a rule
[ ] Add a CLI option
[ ] Add something to the core
[ ] Other, please explain:

What changes did you make? (Give an overview)

Adds a /use/troubleshooting page with sub-pages for three commonly asked-about areas.

Fixes #17986.

Is there anything you'd like reviewers to focus on?

I can't shake the feeling that these pages are much more contextual explanation than actual troubleshooting... but couldn't think of any other troubleshooting tips to add in.

@eslint-github-bot eslint-github-bot bot added the documentation Relates to ESLint's documentation label Mar 9, 2024
@github-actions github-actions bot removed the documentation Relates to ESLint's documentation label Mar 9, 2024
Copy link

netlify bot commented Mar 9, 2024

Deploy Preview for docs-eslint ready!

Name Link
🔨 Latest commit 2c65c65
🔍 Latest deploy log https://app.netlify.com/sites/docs-eslint/deploys/660b012e53f0f600080ddf5c
😎 Deploy Preview https://deploy-preview-18181--docs-eslint.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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

@eslint-github-bot eslint-github-bot bot added the documentation Relates to ESLint's documentation label Mar 9, 2024
@github-actions github-actions bot removed the documentation Relates to ESLint's documentation label Mar 9, 2024
@eslint-github-bot eslint-github-bot bot added the documentation Relates to ESLint's documentation label Mar 9, 2024
@github-actions github-actions bot removed the documentation Relates to ESLint's documentation label Mar 9, 2024
@eslint-github-bot eslint-github-bot bot added the documentation Relates to ESLint's documentation label Mar 9, 2024
@github-actions github-actions bot removed the documentation Relates to ESLint's documentation label Mar 9, 2024
@eslint-github-bot eslint-github-bot bot added the documentation Relates to ESLint's documentation label Mar 9, 2024
@github-actions github-actions bot removed the documentation Relates to ESLint's documentation label Mar 9, 2024
@JoshuaKGoldberg JoshuaKGoldberg marked this pull request as ready for review March 9, 2024 21:39
@JoshuaKGoldberg JoshuaKGoldberg requested a review from a team as a code owner March 9, 2024 21:39
Copy link

Hi everyone, it looks like we lost track of this pull request. Please review and see what the next steps are. This pull request will auto-close in 7 days without an update.

@github-actions github-actions bot added the Stale label Mar 20, 2024
@Tanujkanti4441 Tanujkanti4441 added documentation Relates to ESLint's documentation and removed Stale labels Mar 21, 2024
@github-actions github-actions bot removed the documentation Relates to ESLint's documentation label Mar 21, 2024
Copy link
Member

@nzakas nzakas left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for getting this section started.

Overall, I think the pages need a bit more structure, maybe headings like:

  1. Symptoms - describe the problem and error message
  2. Cause - explain the most likely cause(s) of the problem
  3. Resolution - what to do to try and fix the problem
  4. Further Reading - for any additional resources

@eslint-github-bot eslint-github-bot bot added the documentation Relates to ESLint's documentation label Mar 23, 2024
@github-actions github-actions bot removed the documentation Relates to ESLint's documentation label Mar 23, 2024
@github-actions github-actions bot removed the documentation Relates to ESLint's documentation label Mar 26, 2024
@eslint-github-bot eslint-github-bot bot added the documentation Relates to ESLint's documentation label Mar 26, 2024
@github-actions github-actions bot removed the documentation Relates to ESLint's documentation label Mar 26, 2024
@eslint-github-bot eslint-github-bot bot added the documentation Relates to ESLint's documentation label Mar 26, 2024
@github-actions github-actions bot removed the documentation Relates to ESLint's documentation label Mar 26, 2024
@nzakas
Copy link
Member

nzakas commented Mar 29, 2024

Can you check the lint error?

@eslint-github-bot eslint-github-bot bot added the documentation Relates to ESLint's documentation label Apr 1, 2024
@github-actions github-actions bot removed the documentation Relates to ESLint's documentation label Apr 1, 2024
@eslint-github-bot eslint-github-bot bot added the documentation Relates to ESLint's documentation label Apr 1, 2024
@github-actions github-actions bot removed the documentation Relates to ESLint's documentation label Apr 1, 2024
@eslint-github-bot eslint-github-bot bot added the documentation Relates to ESLint's documentation label Apr 1, 2024
@github-actions github-actions bot removed the documentation Relates to ESLint's documentation label Apr 1, 2024
@JoshuaKGoldberg
Copy link
Contributor Author

It was from the merge from main, since the configuration files docs were renamed. I fixed up the links. 👍

Co-authored-by: Nicholas C. Zakas <nicholas@humanwhocodes.com>
@eslint-github-bot eslint-github-bot bot added the documentation Relates to ESLint's documentation label Apr 1, 2024
@github-actions github-actions bot removed the documentation Relates to ESLint's documentation label Apr 1, 2024
Copy link
Member

@nzakas nzakas left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. Leaving open because the URLs may need to change depending on if we do another RC or not.

@nzakas
Copy link
Member

nzakas commented Apr 4, 2024

URLs are good for tomorrow's release, so merging.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Status: Complete
Development

Successfully merging this pull request may close these issues.

Docs: Add a Troubleshooting page
4 participants