-
Notifications
You must be signed in to change notification settings - Fork 30k
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
doc: add default values to function signatures in fs.md #13767
doc: add default values to function signatures in fs.md #13767
Conversation
Not something to be handled in this PR, but it looks like we do not have consistent styling for default values across our documentation. I see |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Can you update the default values to match the format used in #13769.
Refs: nodejs#13769 New style is introduced in PR nodejs#13769.
@cjihrig Updated. |
@@ -436,7 +436,7 @@ changes: | |||
--> | |||
|
|||
* `path` {string|Buffer|URL} | |||
* `mode` {integer} | |||
* `mode` {integer} **Default:** `fs.constants.F_OK` |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It's good to get consistency here but I would prefer something like:
Defaults to `fs.constants.F_OK`
Without the bold styling.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yea, in general I'm good with improved consistency and won't block this, I just don't prefer the bold styling.
Landed in 51bb4ac, thank you for your contribution! 🎉 |
PR-URL: nodejs#13767 Refs: nodejs#11135 Refs: nodejs#13769 Reviewed-By: Gibson Fahnestock <gibfahn@gmail.com> Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
This is related to #11135
Default values I'm adding to signatures are either mentioned in descriptions in following paragraphs or are duplicated from async versions to sync.
Checklist
Affected core subsystem(s)
doc, fs