René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"doc: child_process.kill() on windows needs clarification","articleBody":"# 📗 API Reference Docs Problem\r\n\r\n\u003c!--\r\n\r\nThank you for wanting to make nodejs.org better!\r\n\r\nThis template is for issues with the Node.js API\r\nreference documentation.\r\n\r\nFor problems with nodejs.org beyond the API\r\nreference documentation, please open an issue\r\nusing the issue tracker for our site repository.\r\n\r\n  https://github.com/nodejs/nodejs.org\r\n\r\nFor more general support, please open an issue\r\nusing the issue tracker for our help repository.\r\n\r\n  https://github.com/nodejs/help\r\n\r\n---\r\n\r\nFor the issue title, please enter a one-line\r\nsummary after “doc: ” (preferably 50 characters\r\nor less and no more than 72).\r\n\r\nThe “✍️” are placeholders signifying requests for\r\ninput. Replace them with your responses.\r\n\r\nIf you are unsure of something, do your best.\r\n\r\n-->\r\n\r\n\u003c!-- The output of “node --version”. -->\r\n\r\n- **Version**: v14 and previous ones as well, like v12 LTS\r\n\r\n\u003c!-- The output of “uname -a” (UNIX) or version\r\nand 32-bit or 64-bit (Windows). -->\r\n\r\n- **Platform**: Windows\r\n\r\n\u003c!-- The name of affected core module. -->\r\n\r\n- **Subsystem**: child_process signals\r\n\r\n## Location\r\n\r\n_Section of the site where the content exists_\r\n\r\nAffected URL(s):\r\n\r\n- https://nodejs.org/api/child_process.html\r\n\r\n## Description\r\n\r\n_Concise explanation of the problem_\r\n\r\n\u003c!-- If applicable, include any screenshots that\r\nmay help solve the problem. -->\r\n\r\nThe NodeJS signals documentation (https://nodejs.org/api/process.html#process_signal_events) is pretty clear that on windows child_process.kill(\u003csignal here>) does NOT actually send the signal, but rather just kills the child process abruptly.\r\n\r\nHowever, the child_process.kill() documentation does not make this clarification, and it's opening sentence (\"The subprocess.kill() method sends a signal to the child process. \") leads one to believe that the signal will in fact be sent to the child process on any platform, windows included.\r\n\r\nI'd love to just see a quick blurb/sentence that clarifies the behavior on windows vs other platforms (or perhaps just a link pointing to the signals documentation - https://nodejs.org/api/process.html#process_signal_events).\r\n\r\n---\r\n\r\n\u003c!-- Use “[x]” to check the box below if you are\r\ninterested in contributing. -->\r\n\r\n- [ ] I would like to work on this issue and\r\n      submit a pull request.\r\n","author":{"url":"https://github.com/s4m0r4m4","@type":"Person","name":"s4m0r4m4"},"datePublished":"2020-08-20T21:00:14Z","url":"https://github.com/nodejs/node/issues/34858"}