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: add missing type=misc top comments #20022

Closed
wants to merge 1 commit into from
Closed

doc: add missing type=misc top comments #20022

wants to merge 1 commit into from

Conversation

vsemozhetbyt
Copy link
Contributor

@vsemozhetbyt vsemozhetbyt commented Apr 14, 2018

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

If I get this right, we have two types of docs: concerning require-able modules and other docs.

Other docs usually have top level <!-- type=misc --> comments, so that the top JSON container for them would be miscs (compare a require-able module doc). These docs adhere this rule:

  • cli.md
  • debugger.md
  • documentation.md
  • errors.md
  • globals.md
  • synopsis.md

These ones seem to lack these comments:

  • addons.md
  • deprecations.md
  • esm.md
  • intl.md
  • n-api.md

addons, esm, and n-api docs concern importable modules, but they are mostly tutorials, not module API docs. I may be wrong in these cases, so correct me if so.

As for tracing.md, it will become a require-able module doc soon, so the mentioned comment is not needed there now.

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

@vsemozhetbyt
Copy link
Contributor Author

Landed in 72dc1ae

@vsemozhetbyt vsemozhetbyt deleted the type-misc branch April 14, 2018 11:56
vsemozhetbyt added a commit that referenced this pull request Apr 14, 2018
PR-URL: #20022
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Trivikram Kamat <trivikr.dev@gmail.com>
jasnell pushed a commit that referenced this pull request Apr 16, 2018
PR-URL: #20022
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Trivikram Kamat <trivikr.dev@gmail.com>
BridgeAR pushed a commit to BridgeAR/node that referenced this pull request May 1, 2018
PR-URL: nodejs#20022
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Trivikram Kamat <trivikr.dev@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
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