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

faq typos #8357

Merged
merged 5 commits into from Nov 21, 2021
Merged

faq typos #8357

merged 5 commits into from Nov 21, 2021

Conversation

paulsmithkc
Copy link
Contributor

Fixing a few minor typos in the FAQ. See committed changes.

fixing a few minor typos in the faq
accont -> account
@remix-cla-bot
Copy link
Contributor

remix-cla-bot bot commented Nov 18, 2021

Hi @paulsmithkc,

Welcome, and thank you for contributing to React Router!

Before we consider your pull request, we ask that you sign our Contributor License Agreement (CLA). We require this only once.

You may review the CLA and sign it by adding your name to contributors.yml.

Once the CLA is signed, the CLA Signed label will be added to the pull request.

If you have already signed the CLA and received this response in error, or if you have any questions, please contact us at hello@remix.run.

Thanks!

- The Remix team

@remix-cla-bot
Copy link
Contributor

remix-cla-bot bot commented Nov 18, 2021

Thank you for signing the Contributor License Agreement. Let's get this merged! 🥳

@mjackson
Copy link
Member

Thanks for submitting this PR, @paulsmithkc.

@mcansh Can you please help get this merged? I'm not sure why the Prettier check is failing. The code looks ok.

I know @timdorr suggested that we add the formatting check to GH actions, which I believe is ideal, but it's frustrating when it causes stuff like this to fail. Do we need to set it up so that it automatically runs on people's machines before they make a commit and a PR? Or is the code already formatted correctly in this PR and GH actions is just being flaky?

mcansh and others added 2 commits November 21, 2021 11:26
Signed-off-by: Logan McAnsh <logan@mcan.sh>
@mcansh
Copy link
Collaborator

mcansh commented Nov 21, 2021

the edited code was fine, but there were some existing formatting issues in the file, I wonder if we can have prettier run and have it commit the needed formatting changes to the PR

@mcansh
Copy link
Collaborator

mcansh commented Nov 21, 2021

I think a commit hook to format modified files is good to add also, but that doesn't cover commits from GitHub.com or GitHub.dev (i think)

@mcansh mcansh merged commit 57407d3 into remix-run:main Nov 21, 2021
@mjackson
Copy link
Member

I wonder if we can have prettier run and have it commit the needed formatting changes to the PR

That's an interesting idea... looks like someone made a bot to do it: https://www.prettifier.io/

I'd say we either a) use a bot to automatically fix formatting errors or b) remove the formatting check from the build and just do it manually whenever someone feels like it. Making people go back and add another commit to the PR for formatting errors is a huge killjoy IMO.

@mcansh Wanna try out prettifier?

@timdorr
Copy link
Member

timdorr commented Nov 22, 2021

You can use Husky to run it pre-commit and ensure things are formatted. Folks editing via the web won't have such tooling, so that's still a case that will fail. Not much you can do about that.

Regardless, I know it's annoying, but format checks are actually pretty important in an open source project nowadays. Besides the obvious benefits of an opinionated formatter, Prettier is so popular nowadays that it's going to be run on a lot of PRs by default. If you accept PRs without formatting, once someone comes along and uses Prettier by default, they will end up creating a lot of commit noise when those unformatted lines are finally formatted. This is more apparent in a monofile project like Router, since a lot of folks will touch that one file for their PRs. It creates a messy review process.

I think it's already the case, but I would make sure the formatting happens as quickly as possible to make feedback quick. It may be helpful to use a dedicated Prettier GitHub Action, as it will already have the tool installed and you can run it directly after checkout. That should give you the fastest feedback possible and catch more users while they've still got the code open on their machines.

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

Successfully merging this pull request may close these issues.

None yet

4 participants