You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Aug 1, 2019. It is now read-only.
Repository navigation
This repository was archived by the owner on Aug 1, 2019. It is now read-only.
nodeschool workshopper/tutorial for how to get node installed #200
over at the inclusivity group, we discussed on pre-conference education for first-timers and newcomers to node. the idea of a nodeschool workshopper focusing on how to install node was brought up, but there are still points to clear (such as how to install the workshopper in the first place, assuming node isn't installed). nevertheless, i believe that this is an interesting topic and might help people get into node more easily (which is what the inclusivity project is all about!)
The first though I had was that we could use electron to embed node / browser based terminal to get people through the first steps on their own machines. The application could do some basic vendor checking and then offer a getting started tutorial for various install methods / tool chains.
Essentially this stand alone app could itself become a template for writing onboarding documentation
that was what I am imagining. That being said @mikeal raises a good point about how that would scale. I'm not convinced that we can truly scale with only hands on on boarding though.
@thealphanerd I'm imagining that as we do these by hand we can slowly improve the documentation around install issues and setting up environments until we have something comprehensive.
Just some context here... In late February I will be running a NodeSchool
type lab at IBMs InterConnect conference. @thealphanerd and I are working
on the agenda and materials. I'm hoping that we can use it as a test for
evolving these kinds of tools.
On Dec 18, 2015 12:38 PM, "Mikeal Rogers" notifications@github.com wrote:
So, I'm going to get a little pie in the sky here, but what would be best
is a more humane installer.
If we could create an installer, maybe with Electron, that:
Installs Node.js
Tests that Node.js works properly.
Tests that npm works properly and fixes common permission errors.
Offers additional help (in-app documentation) on setting up your
environment and using npm.
This could be huge for us as nearly every new user trips over one of these
things. It would make Node.js the easier platform to get up and going on.
@watson was working on a page for the nodeschool website with really detailed install instructions, but I can't find it right now (it was never finished, but had a good start)
fwiw there is some prior art here, sort of. goingnative's first exercise is an environment test to make sure you have what you need. Since add-ons are such an essential part of node development, this might be something to include as an extra step beyond the basic setup.
Activity
MylesBorins commentedon Dec 18, 2015
The first though I had was that we could use electron to embed node / browser based terminal to get people through the first steps on their own machines. The application could do some basic vendor checking and then offer a getting started tutorial for various install methods / tool chains.
Essentially this stand alone app could itself become a template for writing onboarding documentation
MylesBorins commentedon Dec 18, 2015
that was what I am imagining. That being said @mikeal raises a good point about how that would scale. I'm not convinced that we can truly scale with only hands on on boarding though.
mikeal commentedon Dec 18, 2015
@thealphanerd I'm imagining that as we do these by hand we can slowly improve the documentation around install issues and setting up environments until we have something comprehensive.
mikeal commentedon Dec 18, 2015
@sup literally sitting next to someone and helping them figure it out :)
mikeal commentedon Dec 18, 2015
So, I'm going to get a little pie in the sky here, but what would be best is a more humane installer.
If we could create an installer, maybe with Electron, that:
This could be huge for us as nearly every new user trips over one of these things. It would make Node.js the easiest platform to get up and going on.
Thoughts? @maxogden @ashleygwilliams
jasnell commentedon Dec 18, 2015
Just some context here... In late February I will be running a NodeSchool
type lab at IBMs InterConnect conference. @thealphanerd and I are working
on the agenda and materials. I'm hoping that we can use it as a test for
evolving these kinds of tools.
On Dec 18, 2015 12:38 PM, "Mikeal Rogers" notifications@github.com wrote:
max-mapper commentedon Dec 18, 2015
@watson was working on a page for the nodeschool website with really detailed install instructions, but I can't find it right now (it was never finished, but had a good start)
watson commentedon Dec 21, 2015
@maxogden yeah, it's on my always growing todo list of bad conscience: nodeschool/nodeschool.github.io#390
MylesBorins commentedon Dec 21, 2015
@watson would you appreciate an external iteration?
watson commentedon Dec 22, 2015
@thealphanerd I'd appreciate all the help I can get 😃
Knighton910 commentedon Dec 22, 2015
@mikeal That's a great idea. It streamlines the process 🎉 and your up & running 🏃 with no headaches & online searching for installation resources.
rvagg commentedon Dec 23, 2015
fwiw there is some prior art here, sort of. goingnative's first exercise is an environment test to make sure you have what you need. Since add-ons are such an essential part of node development, this might be something to include as an extra step beyond the basic setup.
seabaylea commentedon Dec 29, 2015
@jasnell I'm also due to be at IBMs InterConnect conference if some more on-site hands would be useful.
bnb commentedon Aug 17, 2017
@pup / @jasnell is this able to be closed? Can't tell what kind of resolution it came to. 🙏
jasnell commentedon Aug 18, 2017
Yeah I'd say this can be closed