create targeted tutorials on yargs website

[bcoe]

like the approach we're starting to take with http://istanbul.js.org/, I'd love to see us split our very long yargs README document into various targeted tutorials. e.g.,

• using commands (CC: @nexdrew).
• argument validation (CC: @lrlna).

What do you think? also looping in @maxrimue @Charlotteis.

[varjmes]

Hey @bcoe!

That sounds fantastic. I'm on board.
puts hand in
Go team!

✨

[bcoe]

@Charlotteis I was thinking as a stop gap, until we can write some content, putting a link to a Gitter chat on the website would be good, and in the yargs README.md; various folks have requested this.

[lrlna]

hey folks!

I've had ideas to do this forever and literally never got around to it. Ideally I would like to see it as a set of tutorials set up as levels: i.e. first you want to get your options, then you want to have options with aliases, then you want to use a command builder. Basically you level-up. I think as a first thing, I want to compile a list of exact tutorials, and then start building them one by one. Maybe even release one weekly, like a newsletter \o/ ?

I also think they should be relevant to what people normally do, so I ran a twitter quetionnaire, so I can hopefully get some data. I know I've written a bunch of tests with marsupial examples, but I think we should have these as IRL stuff.

[lrlna]

In fact, so I give myself some deadlines, I'll start with option parsing this week and actually get it done.

[varjmes]

I was thinking as a stop gap, until we can write some content, putting a link to a Gitter chat on the website would be good, and in the yargs README.md; various folks have requested this

I am biased toward Slack, but that sounds like a good idea as any :)

I've had ideas to do this forever and literally never got around to it. Ideally I would like to see it as a set of tutorials set up as levels: i.e. first you want to get your options, then you want to have options with aliases, then you want to use a command builder. Basically you level-up. I think as a first thing, I want to compile a list of exact tutorials, and then start building them one by one. Maybe even release one weekly, like a newsletter \o/ ?

I love this. Too many times do I get tutorials that are "HERE ARE ALL THE THINGS, BYE!!!!"
I like the idea of "you have done this, now try this, yay awesome learning, next up is this!"

[bcoe]

@Charlotteis would you like to join the yargs maintainer slack? if so what email should I send an invite to?

[varjmes]

@bcoe charlottelaspencer@gmail.com :)