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

In "Installing Java" instructions, minimize the length of the onramp. #395

Closed
jtigger opened this issue Mar 21, 2017 · 3 comments
Closed
Labels

Comments

@jtigger
Copy link
Contributor

jtigger commented Mar 21, 2017

The Installing Java instructions should seek to minimize the number of steps and the number of concepts a new-to-the-track practitioner needs to learn to get to coding.

An example of this came up in #295. Linking to the Chocolatey site for installation instructions was tantamount to tossing the practitioner in the deep end of the pool; those instructions were not context-free and not easy to follow. In contrast, we found a simple one-liner that has been verified (#348) on the latest version of the OS (and had been previously tested on earlier versions).

@rado-radoev
Copy link
Contributor

If you are thinking of just combining all steps into one. I am pretty sure we can set up a PowerShell script that does all that and checks for the exit code of the installs to make sure everything is installed correctly. I am thinking of something that either has command line switches (-choco -jdk8 -gradle), or just gives the user option on what to install at the beginning.

@jtigger
Copy link
Contributor Author

jtigger commented Mar 21, 2017

Ah! Well, yeah, there needs to be a balance...

The balancing "force" is that we'd also like to minimize in how much "magic" occurs too.

If they are tools you should be aware that they exist (like Gradle and the JDK), I believe it's worth the experience of doing the install.

The lower-level details (such as what environment variables need to be set, OS path, etc) actually become a real pain/distraction without adding any real value for the new-to-the-platform person.

@FridaTveit
Copy link
Contributor

Closing this issue as it has been included in the POLICIES doc :)

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

No branches or pull requests

3 participants