Skip to content

docs: linting onboarding guides #1324

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

Merged
merged 5 commits into from
Dec 18, 2019
Merged

docs: linting onboarding guides #1324

merged 5 commits into from
Dec 18, 2019

Conversation

bradzacher
Copy link
Member

@bradzacher bradzacher commented Dec 11, 2019

Fixes #1298

It's too hard to onboard as a new user. There are too many docs written in huge readmes, spread across too many packages.

This creates a centralised, simple, package-agnostic guide for people to follow.

Also because there's a lot of text here, I added a markdown spellchecker (and ran it across the codebase). I figured this would also help prevent future minor spelling PRs that we gotten a number of. As much as it pained me to do it, I set it to en-us.

Changes:

  • Adds linting onboarding docs
  • Removes sections around the place which had some of this information
  • Adds links to these new docs
  • Adds a markdown spellchecker to help ensure nobody borks spelling.
    • fixes spelling all over the place
  • Adds a basic CONTRIBUTING.md which echos everything I've been telling people forever.

@bradzacher bradzacher added the documentation Documentation ("docs") that needs adding/updating label Dec 11, 2019
@typescript-eslint
Copy link
Contributor

Thanks for the PR, @bradzacher!

typescript-eslint is a 100% community driven project, and we are incredibly grateful that you are contributing to that community.

The core maintainers work on this in their personal time, so please understand that it may not be possible for them to review your work immediately.

Thanks again!


🙏 Please, if you or your company is finding typescript-eslint valuable, help us sustain the project by sponsoring it transparently on https://opencollective.com/typescript-eslint. As a thank you, your profile/company logo will be added to our main README which receives thousands of unique visitors per day.

@bradzacher bradzacher changed the title docs: onboarding guides docs: linting onboarding guides Dec 17, 2019
@bradzacher bradzacher marked this pull request as ready for review December 17, 2019 14:55
@bradzacher bradzacher merged commit 3e06f0f into master Dec 18, 2019
@bradzacher bradzacher deleted the onboarding-docs branch December 18, 2019 00:25
@armano2
Copy link
Collaborator

armano2 commented Dec 18, 2019

small note, i think you missed updating README.md with link to CONTRIBUTING.md

Contributing Guide
COMING SOON

@github-actions github-actions bot locked as resolved and limited conversation to collaborators Apr 20, 2020
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
documentation Documentation ("docs") that needs adding/updating
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Getting started: More use cases
2 participants