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

Clarify Windows install instructions #721

crivaldi opened this Issue Mar 2, 2018 · 3 comments


None yet
3 participants

crivaldi commented Mar 2, 2018

Some users may be confused about installing native bash on windows 10 because this has changed to a ubuntu application through the windows store. In addition, for very novice users, they might think this is the command prompt, and so be stuck for a while entering commands there to no avail (particularly if they think they are in a shell).
Hope this was helpful!


This comment has been minimized.


colinmorris commented Mar 2, 2018

Hey @crivaldi , have you seen the Windows install instructions in the setup section? Our primary recommendation right now is the Bash shell that comes with Git for Windows (which I think has pretty good support across different Windows versions?).

If you think those instructions could be made clearer, we're definitely open to suggestions.


This comment has been minimized.


shwina commented Mar 2, 2018

One thing that could be made clearer is that that Windows does come with a shell (CMD or 'Command Prompt') which has a completely different syntax than the Unix shell. However, the clarification must written very carefully, as now Windows does support bash..


This comment has been minimized.

crivaldi commented Mar 3, 2018

Thanks for replies - I do agree that using git bash is great for the lesson - easiest thing by far.

My comment is directed at the instruction for users who wish to use an alternative for some reason (or those who simply wish to go back and install after the workshop). It's a little confusing to newcomers to have the words Bash, Ubuntu, Linux, shell, etc. Also, like @shwina mentioned, there is also a shell that comes in windows that can make this really confusing on top of all that.

For example:

Other solutions are available for running Bash commands on Windows systems. There is now a Bash shell command-line tool available for Windows 10. Additionally....

Could be altered into something like:
Other solutions are available for running Bash commands on Windows systems. There is now a Bash through Ubuntu command-line tool available for Windows 10 (note: this is different from the Command Prompt, which uses a different syntax than this lesson covers). Additionally....

@colinmorris colinmorris changed the title from Windows install instructions to Clarify Windows install instructions Mar 5, 2018

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