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

doc: unify more headings #20046

Closed
wants to merge 1 commit into from
Closed

doc: unify more headings #20046

wants to merge 1 commit into from

Conversation

vsemozhetbyt
Copy link
Contributor

@vsemozhetbyt vsemozhetbyt commented Apr 15, 2018

Checklist
  • make -j4 test (UNIX), or vcbuild test (Windows) passes
  • documentation is changed or added
  • commit message follows commit guidelines
  • Unify punctuation.
  • Unify case.
  • Unify format nits (add new for a constructor, remove () from a class name).
  • Unify backticks. We usually do not wrap headings in backticks if these headings contain only API properties or function signatures. In such cases, backticks break uniformity, reduce font size in TOC and headings and baffle doctools.

Also in passing:

  • Fix a typo.
  • Add a type.

@vsemozhetbyt vsemozhetbyt added the fast-track PRs that do not need to wait for 48 hours to land. label Apr 15, 2018
@nodejs-github-bot nodejs-github-bot added the doc Issues and PRs related to the documentations. label Apr 15, 2018
@vsemozhetbyt
Copy link
Contributor Author

Copy link
Member

@trivikr trivikr left a comment

Choose a reason for hiding this comment

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

More backticks need to be removed from headings under Implementation Considerations

@vsemozhetbyt
Copy link
Contributor Author

vsemozhetbyt commented Apr 15, 2018

@trivikr I've seen them, but abstained from deletion: these are not formal API sections, just extra notes about previously described API. The similar cases are these subsections:

https://github.com/nodejs/node/blob/master/doc/api/async_hooks.md#type
https://github.com/nodejs/node/blob/master/doc/api/async_hooks.md#triggerid
https://github.com/nodejs/node/blob/master/doc/api/async_hooks.md#resource

They describe parameters from the previous formal signature in more details.

All these should not be parsed by, say, JSON doctools as formal API parts, just as misc sections.

@BridgeAR BridgeAR added the author ready PRs that have at least one approval, no pending requests for changes, and a CI started. label Apr 15, 2018
@vsemozhetbyt
Copy link
Contributor Author

Landed in 6e869be

@vsemozhetbyt vsemozhetbyt deleted the doc-unify-more-headings branch April 16, 2018 11:05
vsemozhetbyt added a commit that referenced this pull request Apr 16, 2018
PR-URL: #20046
Reviewed-By: Trivikram Kamat <[email protected]>
Reviewed-By: Ruben Bridgewater <[email protected]>
jasnell pushed a commit that referenced this pull request Apr 16, 2018
PR-URL: #20046
Reviewed-By: Trivikram Kamat <[email protected]>
Reviewed-By: Ruben Bridgewater <[email protected]>
BridgeAR pushed a commit to BridgeAR/node that referenced this pull request May 1, 2018
PR-URL: nodejs#20046
Reviewed-By: Trivikram Kamat <[email protected]>
Reviewed-By: Ruben Bridgewater <[email protected]>
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. doc Issues and PRs related to the documentations. fast-track PRs that do not need to wait for 48 hours to land.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants