{"action":"created","issue":{"url":"https://api.github.com/repos/nodejs/node/issues/3772","labels_url":"https://api.github.com/repos/nodejs/node/issues/3772/labels{/name}","comments_url":"https://api.github.com/repos/nodejs/node/issues/3772/comments","events_url":"https://api.github.com/repos/nodejs/node/issues/3772/events","html_url":"https://github.com/nodejs/node/pull/3772","id":116345648,"number":3772,"title":"Added notes on special .write callback behaviour on process.stdout/.stderr","user":{"login":"minesworld","id":10605116,"avatar_url":"https://avatars.githubusercontent.com/u/10605116?v=3","gravatar_id":"","url":"https://api.github.com/users/minesworld","html_url":"https://github.com/minesworld","followers_url":"https://api.github.com/users/minesworld/followers","following_url":"https://api.github.com/users/minesworld/following{/other_user}","gists_url":"https://api.github.com/users/minesworld/gists{/gist_id}","starred_url":"https://api.github.com/users/minesworld/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/minesworld/subscriptions","organizations_url":"https://api.github.com/users/minesworld/orgs","repos_url":"https://api.github.com/users/minesworld/repos","events_url":"https://api.github.com/users/minesworld/events{/privacy}","received_events_url":"https://api.github.com/users/minesworld/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/nodejs/node/labels/doc","name":"doc","color":"006b75"},{"url":"https://api.github.com/repos/nodejs/node/labels/process","name":"process","color":"00aaff"},{"url":"https://api.github.com/repos/nodejs/node/labels/stream","name":"stream","color":"c7def8"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":11,"created_at":"2015-11-11T14:32:21Z","updated_at":"2015-11-18T13:28:29Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/nodejs/node/pulls/3772","html_url":"https://github.com/nodejs/node/pull/3772","diff_url":"https://github.com/nodejs/node/pull/3772.diff","patch_url":"https://github.com/nodejs/node/pull/3772.patch"},"body":"This \"solves\" issue https://github.com/nodejs/node/issues/3670 and the issues of the underlying bug..."},"comment":{"url":"https://api.github.com/repos/nodejs/node/issues/comments/157713011","html_url":"https://github.com/nodejs/node/pull/3772#issuecomment-157713011","issue_url":"https://api.github.com/repos/nodejs/node/issues/3772","id":157713011,"user":{"login":"jasnell","id":439929,"avatar_url":"https://avatars.githubusercontent.com/u/439929?v=3","gravatar_id":"","url":"https://api.github.com/users/jasnell","html_url":"https://github.com/jasnell","followers_url":"https://api.github.com/users/jasnell/followers","following_url":"https://api.github.com/users/jasnell/following{/other_user}","gists_url":"https://api.github.com/users/jasnell/gists{/gist_id}","starred_url":"https://api.github.com/users/jasnell/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jasnell/subscriptions","organizations_url":"https://api.github.com/users/jasnell/orgs","repos_url":"https://api.github.com/users/jasnell/repos","events_url":"https://api.github.com/users/jasnell/events{/privacy}","received_events_url":"https://api.github.com/users/jasnell/received_events","type":"User","site_admin":false},"created_at":"2015-11-18T13:28:29Z","updated_at":"2015-11-18T13:28:29Z","body":"I agree that the current docs are lacking here and definitely appreciate\nyour work helping to improve them. Issues around this have come up before.\nI think, however, that there is some nuance here that is being missed. Node\ndoes take a slightly different approach to this than other languages so\nthere will be differences. I'll sit down a bit later to go through this PR\nand the existing docs again to see what more can be done.\nOn Nov 18, 2015 4:23 AM, \"minesworld\" <notifications@github.com> wrote:\n\n> @jasnell <https://github.com/jasnell> , @bnoordhuis\n> <https://github.com/bnoordhuis> OK\n> The documenation says on writable.write:\n> callback Function Callback for when this chunk of data is flushed\n> This method writes some data to the underlying system, and calls the\n> supplied callback once the data has been fully handled.\n>\n> What do you think does \"flushed\" and \"fully handled\" mean for \"normal\"\n> programmers?\n>\n> On every other serious language I would be able to somehow call the os\n> flush() function also on process.stdout and process.stderr as this is the\n> only way to ensure that all data could be handled by a consumer no matter\n> what.\n>\n> Yes - you can redefine the meaning of \"flushed\".\n>\n> I don't want to write what I think about doing so without telling the\n> users of your project.\n>\n> The issue will come up again as long as the underlying bug is not fixed or\n> the documentation doesn't make it clear.\n>\n> As promised I changed the docs. Do what you want with it.\n>\n> As I can reproduce it in production writing TB to stdout, I'm off this\n> \"kindergarten\" here...\n>\n> —\n> Reply to this email directly or view it on GitHub\n> <https://github.com/nodejs/node/pull/3772#issuecomment-157694188>.\n>\n"}}