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

the "streams" exercise needs more details and hints #126

Open
Pomax opened this issue Jan 13, 2015 · 2 comments
Open

the "streams" exercise needs more details and hints #126

Pomax opened this issue Jan 13, 2015 · 2 comments

Comments

@Pomax
Copy link

Pomax commented Jan 13, 2015

people new to hapi are likely not to be Node experts, and thus entirely likely to never have worked with streams and the .pipe() function before.

While the hints do cover how to create a stream, it does not cover how the rot13-transform library is supposed to be used in conjunction with streams, nor is a link provided for reading the API for this library, making "doing the assignment" more of a "hunt for other tutorials to explain how to use streams and the indicated library".

It would be a good idea to at least explain how to use streams with .pipe() and what not to do when you do read up on streams (e.g. don't end with a pipe(process.stdout), which you might be tempted to do when you read https://www.npmjs.com/package/rot13-transform in order to find out how to use it, because Hapi will be adding more pipes)

@nvcexploder
Copy link
Contributor

Do you think that this merits being split into a new workshopper? I have been out on Holiday, but some things that @nelsonic had mentioned before have really resonated. I feel there needs to be at least two: one specifically for beginners that have less node and/or web experience, and one for folks that are prepared to go a bit deeper into the framework.

@Pomax
Copy link
Author

Pomax commented Jan 14, 2015

Hm, not really; I thinks the assignments can simply work people up to basic stream understanding. If you know streams, then this should be an easy assignment; if you don't, the assignment text and hints can probably be phrased so that even someone unfamiliar with streams at least "gets" the idea behind opening a stream, piping the data through filters, and then handing it off to "whatever does the rest" while they're doing the assignment.

@nvcexploder nvcexploder modified the milestone: 1.0.3 Jan 28, 2015
@fiveisprime fiveisprime removed this from the 1.0.3 milestone Aug 14, 2015
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

No branches or pull requests

3 participants