René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"doc: fs.ReadStream and fs.WriteStream public/private 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--\u003e\r\n\r\n\u003c!-- The output of “node --version”. --\u003e\r\n\r\n- **Version**: since v0.10x\r\n\r\n\u003c!-- The output of “uname -a” (UNIX) or version\r\nand 32-bit or 64-bit (Windows). --\u003e\r\n\r\n- **Platform**: all\r\n\r\n\u003c!-- The name of affected core module. --\u003e\r\n\r\n- **Subsystem**: fs\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/dist/latest-v14.x/docs/api/fs.html#fs_class_fs_readstream\r\n- https://nodejs.org/dist/latest-v14.x/docs/api/fs.html#fs_class_fs_writestream\r\n\r\n## Description\r\n\r\nI know the `fs.createReadSteam` and `fs.createWriteStream` are the way to go to create streams in the fs module, but i've seen in many examples in the internet people using `new fs.ReadStream` and `new fs.WriteStream`, I believe it would be good to have a clarification in the docs if `fs.ReadStream` and `fs.WriteStream` are considered public and making `new fs.ReadStream` or extendig it, for example, should be considered 'legal' or if otherwise this should be private and we should never use `new fs.ReadStream` or `new fs.WriteStream`.\r\n\r\n\u003c!-- If applicable, include any screenshots that\r\nmay help solve the problem. --\u003e\r\n\r\n✍️\r\n\r\n---\r\n\r\n\u003c!-- Use “[x]” to check the box below if you are\r\ninterested in contributing. --\u003e\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/n3okill","@type":"Person","name":"n3okill"},"datePublished":"2021-10-21T12:53:23.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":0},"url":"https://github.com/40546/node/issues/40546"}