Skip to content

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