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

chore(docs): Be more vocal about not doing type checking #23397

Merged
merged 1 commit into from
Apr 23, 2020

Conversation

skondrashov
Copy link
Contributor

@skondrashov skondrashov commented Apr 23, 2020

Description

I hope this isn't too heavy-handed, but I think that philosophically, this plugin doesn't provide "support" for typescript at all, it just disables it. Typescript is type checking! I admit I don't fully understand the scope of this plugin, but I'm aware of a great number of people on unrelated projects who thought gatsby was doing type checking on build after installing this plugin.

Documentation

This is it :)

Related Issues

Native TypeScript support #18983

I hope this isn't too heavy-handed, but I think that philosophically, this plugin doesn't provide "support" for typescript at all, it just disables it. Typescript _is_ type checking! I admit I don't really understand the purpose of this plugin, but I'm aware of a great number of people who were tricked by this into thinking gatsby was doing type checking on build after installing this plugin.
@skondrashov skondrashov requested a review from a team as a code owner April 23, 2020 02:25
@skondrashov skondrashov changed the title Be more vocal about not doing type checking chore(docs): Be more vocal about not doing type checking Apr 23, 2020
@@ -1,6 +1,6 @@
# gatsby-plugin-typescript

Provides drop-in support for TypeScript and TSX.
Allows Gatsby to build TypeScript and TSX files. Does NOT run type checking during build (see Caveats).
Copy link

Choose a reason for hiding this comment

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

I would even go so far as to bold the second sentence. This fact was a big pain point for my team.

Choose a reason for hiding this comment

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

Why not run type-check as part of CI?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

you should! but this plugin doesn't do it

@laurieontech laurieontech added the type: documentation An issue or pull request for improving or updating Gatsby's documentation label Apr 23, 2020
@laurieontech
Copy link
Contributor

Thanks for the PR! Including something like this makes a lot of sense. And we'll be sure to remove it when the plugin functionality grows!

@laurieontech laurieontech merged commit 39201a1 into gatsbyjs:master Apr 23, 2020
@gatsbot
Copy link

gatsbot bot commented Apr 23, 2020

Holy buckets, @tkondrashov — we just merged your PR to Gatsby! 💪💜

Gatsby is built by awesome people like you. Let us say “thanks” in two ways:

  1. We’d like to send you some Gatsby swag. As a token of our appreciation, you can go to the Gatsby Swag Store and log in with your GitHub account to get a coupon code good for one free piece of swag. We’ve got Gatsby t-shirts, stickers, hats, scrunchies, and much more. (You can also unlock even more free swag with 5 contributions — wink wink nudge nudge.) See gatsby.dev/swag for details.
  2. We just invited you to join the Gatsby organization on GitHub. This will add you to our team of maintainers. Accept the invite by visiting https://github.com/orgs/gatsbyjs/invitation. By joining the team, you’ll be able to label issues, review pull requests, and merge approved pull requests.

If there’s anything we can do to help, please don’t hesitate to reach out to us: tweet at @gatsbyjs and we’ll come a-runnin’.

Thanks again!

pvhee added a commit to marzeelabs/gatsby that referenced this pull request Apr 24, 2020
* 'master' of github.com:gatsbyjs/gatsby: (64 commits)
  Fix recipe test problems (gatsbyjs#23347)
  create blog post announcing extended deadline for Virtual Gatsby Days… (gatsbyjs#23430)
  Correct CFP deadline date on Virtual Gatsby Days registration announcement (gatsbyjs#23432)
  fix(gatsby-recipes): Raise an error when an unknown resource is used (gatsbyjs#23428)
  feat(gatsby-recipes): While apply a step, show the time elapsed after 10 seconds (gatsbyjs#23362)
  markdownASTToHTMLAst isn't async (gatsbyjs#23427)
  Be more vocal about not doing type checking (gatsbyjs#23397)
  docs(gatsby-remark-images): mark `sizeByPixelDensity` as deprecated (gatsbyjs#23387)
  chore(all): Improve renovate (gatsbyjs#23411)
  chore(gatsby): count sift hits in telemetry (gatsbyjs#23416)
  chore(showcase): add GeneOS and COVID KPI (gatsbyjs#23405)
  feat(analytics): defer google analytics script (gatsbyjs#22806)
  docs: mention passing the .tsx file to createPage (gatsbyjs#23329)
  fix(www): tweak docsearch to init algolia when tabbed into (gatsbyjs#23040)
  chore(docs): Fix typo in url (gatsbyjs#23394)
  chore(gatsby-preset-gatsby-package): Remove tsconfig.json (gatsbyjs#23388)
  fix(gatsby-recipes): link to the raw gist of .estlintrc.js (gatsbyjs#23390)
  docs: Create gitlab-continuous-integration.md (gatsbyjs#23367)
  chore(doc): switch zeit now to Vercel Now for Gatsby deployment (gatsbyjs#23346)
  chore(showcase): add Resume on the Web (gatsbyjs#23371)
  ...
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
type: documentation An issue or pull request for improving or updating Gatsby's documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants