Node: doc: guide on backpressure

Created on 12 Jan 2017 · 11Comments · Source: nodejs/node

There is no guide on streams backpressure, however this is one of the most advanced topics of Node.
I am very happy on reviewing the content.

This emerged from the discussion on https://github.com/nodejs/node/pull/10631

cc @sam-github @nodejs/streams @nodejs/documentation

doc good first issue stream

Source

mcollina

👍1

All 11 comments

Hey @mcollina ! I am working on a light overview of streams as an exploratory project -- touched on backpressure a bit. But I would love to help with this issue to gain a deeper understanding!

jalafel on 12 Jan 2017

@jessicaquynh awesome! I would say, send a PR and we can start reviewing

mcollina on 12 Jan 2017

Awesome! Do you recommend following the structure of the existing guides ( ie. pick a project goal and then lead the reader there? )

jalafel on 12 Jan 2017

@jessicaquynh I think so, but I will leave that to @nodejs/documentation.

mcollina on 12 Jan 2017

I'd say, give it a shot in any form. Good content is the best base, for getting this in.

eljefedelrodeodeljefe on 12 Jan 2017

👍1

Note that there is a proposal about moving guides to node/nodejs.org: https://github.com/nodejs/node/issues/10792

joyeecheung on 15 Jan 2017

Would the best bet be to open up the PR on node/nodejs.org? I see that the transfer has yet to land officially, but would love some second opinions on my current draft!

jalafel on 20 Jan 2017

👍1

@jessicaquynh Yes, please do!

gibfahn on 20 Jan 2017

I've opened up a PR on nodejs/nodejs.org, and would love anyone's input, if they care to share it!

There's a more detailed description on what it is missing at the moment in the PR description and would love to collaborate for whoever is up for it! Thanks! :)

jalafel on 23 Jan 2017

👍1

@jessicaquynh good job!!!

mcollina on 25 Jan 2017

Since the guides have been moved to the nodejs.org repo and there's an open PR on this, I'm going to close this so that no one else tries to take it. If anyone feels that it really ought to stay open until that PR lands, feel free to comment or re-open. (I would suggest that we remove the good first contribution label in that case, just to keep it from coming up in people's search results for good first contributions.)