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
Conversation
✅ Deploy Preview for docs-eslint ready!
To edit notification comments on pull requests, go to your Netlify site configuration. |
4c76315
to
1a67fc9
Compare
1a67fc9
to
19908ce
Compare
19908ce
to
ee186eb
Compare
ee186eb
to
468c20f
Compare
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. |
There was a problem hiding this 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:
- Symptoms - describe the problem and error message
- Cause - explain the most likely cause(s) of the problem
- Resolution - what to do to try and fix the problem
- Further Reading - for any additional resources
docs/src/use/troubleshooting/couldnt-determine-the-plugin-uniquely.md
Outdated
Show resolved
Hide resolved
Can you check the lint error? |
It was from the merge from |
Co-authored-by: Nicholas C. Zakas <nicholas@humanwhocodes.com>
There was a problem hiding this 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.
URLs are good for tomorrow's release, so merging. |
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.