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: Mention the interactivity of the installer #8347

Closed
wants to merge 1 commit into from

Conversation

mlangfordsap
Copy link

Having never installed Svelte before today, I was waiting for a long time at the initial prompt for it to... do something. It never did. Not because it was broken, but because the fact I needed to use my arrow keys was not obvious at all. It asked what template I wanted to use, but didn't explain how to make the selection. Once I figured it out (after asking in Discord) it was blatantly obvious, but for a very first time user and after having installed other similar products that don't use this type of interactivity but start with effectively identical commands, it was anything but obvious. Almost made me cross Svelte off my evaluation list.

Having never installed Svelte before today, I was waiting for a long time at the initial prompt for it to... do something.  It never did.  Not because it was broken, but because the fact I needed to use my arrow keys was not obvious at all.  It asked what template I wanted to use, but didn't explain how to make the selection.  Once I figured it out (after asking in Discord) it was blatantly obvious, but for a very first time user and after having installed other similar products that don't use this type of interactivity but start with effectively identical commands, it was anything but obvious.  Almost made me cross Svelte off my evaluation list.
@vercel
Copy link

vercel bot commented Mar 2, 2023

@mlangfordsap is attempting to deploy a commit to the Svelte Team on Vercel.

A member of the Team first needs to authorize it.

@dummdidumm
Copy link
Member

I think it would be better to instead mention this in the prompt dialog itself

@mlangfordsap
Copy link
Author

I think it would be better to instead mention this in the prompt dialog itself

I agree that would definitely a good idea as well. All I know is, as someone who never laid eyes on Svelte until about 2 days ago, this seemingly minor detail was extremely frustrating and almost had me walking away. Looking back, it was so obvious but hindsight is always 20/20. At the time, it felt like the installer was just broken, especially when I did hit the up arrows and the first option duplicated itself 10 times - made it not seem like a prompt so much as some weird CLI bug.

@Conduitry
Copy link
Member

I'm probably +0 on mentioning something in the CLI output that you need to select from the options below or whatever. I'm -1 on calling this out on the docs.

@benmccann
Copy link
Member

Hopefully fixed by sveltejs/kit#9318

@benmccann benmccann closed this Mar 8, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants