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

Add example to fs docs #28365

Closed
wants to merge 4 commits into from
Closed

Conversation

roadev
Copy link
Contributor

@roadev roadev commented Jun 21, 2019

Checklist
  • make -j4 test (UNIX), or vcbuild test (Windows) passes
  • documentation is changed or added
  • commit message follows commit guidelines

@nodejs-github-bot nodejs-github-bot added doc Issues and PRs related to the documentations. fs Issues and PRs related to the fs subsystem / file system. labels Jun 21, 2019
@jasnell jasnell added the code-and-learn Issues related to the Code-and-Learn events and PRs submitted during the events. label Jun 23, 2019
Copy link
Member

@Trott Trott left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Welcome @roadev and thanks for the pull request! I'm not sure this example demonstrates anything to the user about file modes, which is what this section of the documentation is about. Perhaps it should be moved to the parent section about fs.chmod()? The reader shouldn't have to scroll through all the file-mode stuff to get an example of fs.chmod() since they may already know all about file modes....

@roadev
Copy link
Contributor Author

roadev commented Jun 25, 2019

Welcome @roadev and thanks for the pull request! I'm not sure this example demonstrates anything to the user about file modes, which is what this section of the documentation is about. Perhaps it should be moved to the parent section about fs.chmod()? The reader shouldn't have to scroll through all the file-mode stuff to get an example of fs.chmod() since they may already know all about file modes....

You're right @Trott !
I've pushed the changes. Thanks!

doc/api/fs.md Outdated Show resolved Hide resolved
Co-Authored-By: Rich Trott <rtrott@gmail.com>
@Trott Trott added the author ready PRs that have at least one approval, no pending requests for changes, and a CI started. label Jun 26, 2019
@Trott
Copy link
Member

Trott commented Jun 26, 2019

@addaleax
Copy link
Member

addaleax commented Jul 3, 2019

Landed in 41fad84

Thanks for the contribution! 🎉

(If you're interested in other possible contributions to Node.js but don't have a good idea of where to start looking, some ideas are posted at https://www.nodetodo.org/next-steps/.)

@addaleax addaleax closed this Jul 3, 2019
addaleax pushed a commit that referenced this pull request Jul 3, 2019
PR-URL: #28365
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Rich Trott <rtrott@gmail.com>
Reviewed-By: Anna Henningsen <anna@addaleax.net>
targos pushed a commit that referenced this pull request Jul 20, 2019
PR-URL: #28365
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Rich Trott <rtrott@gmail.com>
Reviewed-By: Anna Henningsen <anna@addaleax.net>
This was referenced Jul 23, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
author ready PRs that have at least one approval, no pending requests for changes, and a CI started. code-and-learn Issues related to the Code-and-Learn events and PRs submitted during the events. doc Issues and PRs related to the documentations. fs Issues and PRs related to the fs subsystem / file system.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants