delta/node-new.git/test/doctool, branch Remove-Python-3-tests

tools: make apilinks building more robust

2018-12-18T04:14:24+00:00

1. Move the apilinks.json file into out/doc so it gets cleaned when
  running `make docclean`
2. When the apilinks.json generated is empty, throw a specific error
  so it's easier to understand what's wrong
3. Write to a file passed through CLI arguments instead writing to
  stdout in apilinks.js so the build process is more robust in
  the case of a bad binary

PR-URL: https://github.com/nodejs/node/pull/25019
Reviewed-By: Anna Henningsen 
Reviewed-By: James M Snell

tools,doc: fix version picker bug in html.js

2018-11-28T03:14:54+00:00

The processing of strings like `8.x` into a major version number and a
minor version number results in minor versions that are `NaN`. In that
situation, since the picker will link to the latest docs in the
major version, include the version in the version picker.

Fixes: https://github.com/nodejs/node/issues/23979
PR-URL: https://github.com/nodejs/node/pull/24638
Reviewed-By: Vse Mozhet Byt 
Reviewed-By: Ruben Bridgewater 
Reviewed-By: Refael Ackermann 
Reviewed-By: Luigi Pinca 
Reviewed-By: Franziska Hinkelmann

test: remove unused catch bindings

2018-11-06T15:59:18+00:00

PR-URL: https://github.com/nodejs/node/pull/24079
Reviewed-By: Sam Roberts 
Reviewed-By: Wyatt Preul

doc: remove GA tracking

2018-10-04T05:18:23+00:00

The Google Analytics tracking wasn't wholly uncontroversial and hasn't
been used in practice. Remove it.

PR-URL: https://github.com/nodejs/node/pull/23083
Fixes: https://github.com/nodejs/node/issues/22652
Refs: https://github.com/nodejs/node/pull/6601
Reviewed-By: Richard Lau 
Reviewed-By: Luigi Pinca 
Reviewed-By: Trivikram Kamat 
Reviewed-By: Roman Reiss 
Reviewed-By: James M Snell 
Reviewed-By: Refael Ackermann 
Reviewed-By: Сковорода Никита Андреевич 
Reviewed-By: Anna Henningsen

tools: Include links to source code in documentation

2018-08-30T02:20:46+00:00

Parse source code using acorn; extracting exports.  When producing
documentation, match exports to headers.  When a match is found, add a [src]
link.

This first commit handles simple exported classes and functions, and does so
without requiring any changes to the source code or markdown.  Subsequent
commits will attempt to match more headers, and some of these changes are
likely to require changes to the source code and/or markdown.

PR-URL: https://github.com/nodejs/node/pull/22405
Reviewed-By: James M Snell 
Reviewed-By: Refael Ackermann 
Reviewed-By: Vse Mozhet Byt

tools: produce JSON documentation using unified/remark/rehype

2018-07-25T18:33:06+00:00

PR-URL: https://github.com/nodejs/node/pull/21697
Reviewed-By: Vse Mozhet Byt 
Reviewed-By: Rich Trott 
Reviewed-By: Trivikram Kamat

test: provide better message for orphan output documentation

2018-07-23T19:51:11+00:00

PR-URL: https://github.com/nodejs/node/pull/21913
Reviewed-By: Ruben Bridgewater 
Reviewed-By: Vse Mozhet Byt 
Reviewed-By: Colin Ihrig 
Reviewed-By: Rich Trott 
Reviewed-By: Trivikram Kamat 
Reviewed-By: James M Snell

tools: create HTML docs with unified/remark/rehype

2018-07-20T20:37:40+00:00

PR-URL: https://github.com/nodejs/node/pull/21490
Reviewed-By: Vse Mozhet Byt 
Reviewed-By: Rich Trott

tools: build all.json by combining generated JSON

2018-07-09T19:57:33+00:00

Notes:

1) Removed a number of root properties that did not seem relevant:
   source, desc, and introduced_in.  There no longer is a source, and
   the other two are from the first include and do not reflect the
   entire API.

2) As with https://github.com/nodejs/node/issues/20100, the current
   "desc" properties sometimes contained in-page links, other times
   referenced another page, and often did not match the links in the
   original HTML or JSON file. I chose to standardize on external links
   as "desc" values are isolated snippets as opposed to all.html which
   can be viewed as a standalone and self contained document.

3) Eliminated preprocessing for @include entirely, including the test
   case for this function.

4) _toc.md was renamed to index.md.

5) index comments no longer appear in embedded TOCs (left hand side
   column in the generated documentation.

PR-URL: https://github.com/nodejs/node/pull/21637
Reviewed-By: Vse Mozhet Byt 
Reviewed-By: Rich Trott

test: skip non-doc files in test-make-doc checks

2018-06-27T20:13:40+00:00

PR-URL: https://github.com/nodejs/node/pull/21531
Fixes: https://github.com/nodejs/node/issues/21519
Reviewed-By: Luigi Pinca 
Reviewed-By: Trivikram Kamat 
Reviewed-By: Gus Caplan