From ab494dd1b3814263e1ff8bc6eaa099935d213f90 Mon Sep 17 00:00:00 2001 From: Tom MacWright Date: Thu, 1 Mar 2018 15:18:20 -0800 Subject: [PATCH] feat: use reference links for Markdown output, improving brevity MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Use reference links in Markdown. Fixes https://github.com/documentationjs/documentation/issues/948. This approach might be problematic when inserting markdown under a readme heading if the readme already has link references with conflicting ID’s. * Reference links edits: - fix broken normalize() utility in test suite so that it produces output that doesn't choke referenceLinks. - add DocumentationConfig option `--noReferenceLinks` which will be **internal only**, and turns off reference links for `readme` mode - rebuilds test output with these changes unrelated but minor - includes .prettierrc and updates calls to prettier to use that instead of CLI options * chore: update test snapshots * Update readme snap --- .prettierrc | 3 + __tests__/__snapshots__/bin.js.snap | 138 ++- __tests__/__snapshots__/test.js.snap | 1320 ++++++++++++++++---------- __tests__/utils.js | 5 +- declarations/comment.js | 3 +- docs/NODE_API.md | 96 +- package.json | 5 +- src/commands/readme.js | 1 + src/output/markdown_ast.js | 10 +- yarn.lock | 6 + 10 files changed, 1005 insertions(+), 582 deletions(-) create mode 100644 .prettierrc diff --git a/.prettierrc b/.prettierrc new file mode 100644 index 000000000..544138be4 --- /dev/null +++ b/.prettierrc @@ -0,0 +1,3 @@ +{ + "singleQuote": true +} diff --git a/__tests__/__snapshots__/bin.js.snap b/__tests__/__snapshots__/bin.js.snap index 906e7c597..3a95ca715 100644 --- a/__tests__/__snapshots__/bin.js.snap +++ b/__tests__/__snapshots__/bin.js.snap @@ -1769,36 +1769,36 @@ exports[`build --document-exported 1`] = ` ### Table of Contents -- [z](#z) - - [zMethod](#zmethod) -- [x](#x) -- [Class](#class) - - [classMethod](#classmethod) - - [classGetter](#classgetter) - - [classSetter](#classsetter) - - [staticMethod](#staticmethod) - - [staticGetter](#staticgetter) - - [staticSetter](#staticsetter) -- [T5](#t5) -- [y2Default](#y2default) -- [y4](#y4) -- [object](#object) - - [method](#method) - - [getter](#getter) - - [setter](#setter) - - [prop](#prop) - - [func](#func) -- [f1](#f1) -- [f3](#f3) -- [T](#t) -- [T2](#t2) -- [T4](#t4) -- [f4](#f4) -- [o1](#o1) - - [om1](#om1) -- [f5](#f5) -- [o2](#o2) - - [om2](#om2) +- [z][1] + - [zMethod][2] +- [x][3] +- [Class][4] + - [classMethod][5] + - [classGetter][6] + - [classSetter][7] + - [staticMethod][8] + - [staticGetter][9] + - [staticSetter][10] +- [T5][11] +- [y2Default][12] +- [y4][13] +- [object][14] + - [method][15] + - [getter][16] + - [setter][17] + - [prop][18] + - [func][19] +- [f1][20] +- [f3][21] +- [T][22] +- [T2][23] +- [T4][24] +- [f4][25] +- [o1][26] + - [om1][27] +- [f5][28] +- [o2][29] + - [om2][30] ## z @@ -1814,7 +1814,7 @@ exports[`build --document-exported 1`] = ` **Parameters** -- \`a\` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** +- \`a\` **[string][31]** ### classMethod @@ -1838,7 +1838,7 @@ exports[`build --document-exported 1`] = ` ## T5 -Type: [boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean) +Type: [boolean][32] ## y2Default @@ -1848,7 +1848,7 @@ Description of y3 **Parameters** -- \`p\` **[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)** +- \`p\` **[number][33]** Returns **void** @@ -1874,15 +1874,15 @@ Returns **void** ## T -Type: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number) +Type: [number][33] ## T2 -Type: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) +Type: [string][31] ## T4 -Type: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) +Type: [string][31] ## f4 @@ -1905,6 +1905,72 @@ f5 comment ## o2 ### om2 + +[1]: #z + +[2]: #zmethod + +[3]: #x + +[4]: #class + +[5]: #classmethod + +[6]: #classgetter + +[7]: #classsetter + +[8]: #staticmethod + +[9]: #staticgetter + +[10]: #staticsetter + +[11]: #t5 + +[12]: #y2default + +[13]: #y4 + +[14]: #object + +[15]: #method + +[16]: #getter + +[17]: #setter + +[18]: #prop + +[19]: #func + +[20]: #f1 + +[21]: #f3 + +[22]: #t + +[23]: #t2 + +[24]: #t4 + +[25]: #f4 + +[26]: #o1 + +[27]: #om1 + +[28]: #f5 + +[29]: #o2 + +[30]: #om2 + +[31]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String + +[32]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean + +[33]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number " `; diff --git a/__tests__/__snapshots__/test.js.snap b/__tests__/__snapshots__/test.js.snap index d87d1255c..5d001de06 100644 --- a/__tests__/__snapshots__/test.js.snap +++ b/__tests__/__snapshots__/test.js.snap @@ -9,7 +9,7 @@ This is my class, a demo thing. **Properties** -- \`howMany\` **[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)** how many things it contains +- \`howMany\` **[number][1]** how many things it contains ### getFoo @@ -17,20 +17,26 @@ Get the number 42 **Parameters** -- \`getIt\` **[boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)** whether to get the number +- \`getIt\` **[boolean][2]** whether to get the number -Returns **[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)** forty-two +Returns **[number][1]** forty-two ### getUndefined Get undefined -Returns **[undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined)** does not return anything. +Returns **[undefined][3]** does not return anything. ## Hello World + +[1]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number + +[2]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean + +[3]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined " `; @@ -584,7 +590,10 @@ Array [ Object { "augments": Array [], "context": Object { - "github": "[github]", + "github": Object { + "path": "[github]", + "url": "[github]", + }, "loc": SourceLocation { "end": Position { "column": 2, @@ -762,11 +771,15 @@ exports[`git option 2`] = ` ## simple.input -[undefined:5-8](<> \\"Source code on GitHub\\") +[\\\\[github\\\\]:5-8][1] This function returns the number one. -Returns **[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)** numberone +Returns **[number][2]** numberone + +[1]: [github] \\"Source code on GitHub\\" + +[2]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number " `; @@ -796,10 +809,16 @@ myFoo.foo(42); } \`\`\` -- Throws **[Error](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Error)** if you give it something -- Throws **[TypeError](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/TypeError)** if you give it something else +- Throws **[Error][1]** if you give it something +- Throws **[TypeError][2]** if you give it something else + +Returns **[Number][3]** numberone + +[1]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Error + +[2]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/TypeError -Returns **[Number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)** numberone +[3]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number " `; @@ -3583,9 +3602,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -3716,9 +3735,9 @@ Object { "value": "boolean", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -3787,9 +3806,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -3896,9 +3915,9 @@ Object { "value": "undefined", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined", + "identifier": "3", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -3945,6 +3964,24 @@ Object { ], "type": "paragraph", }, + Object { + "identifier": "1", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + }, + Object { + "identifier": "2", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean", + }, + Object { + "identifier": "3", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined", + }, ], "type": "root", } @@ -6200,9 +6237,9 @@ Object { "value": "string", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -6378,9 +6415,9 @@ Object { "value": "boolean", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, ], "type": "paragraph", @@ -6472,9 +6509,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "3", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -6655,9 +6692,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "3", + "referenceType": "full", + "type": "linkReference", }, ], "type": "paragraph", @@ -6685,9 +6722,9 @@ Object { "value": "string", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "paragraph", @@ -6715,9 +6752,9 @@ Object { "value": "string", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "paragraph", @@ -6909,6 +6946,24 @@ Object { "depth": 3, "type": "heading", }, + Object { + "identifier": "1", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + }, + Object { + "identifier": "2", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean", + }, + Object { + "identifier": "3", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + }, ], "type": "root", } @@ -10126,9 +10181,9 @@ have any parameter descriptions.", "value": "Object", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -10360,9 +10415,9 @@ have any parameter descriptions.", "value": "Array", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -10544,9 +10599,9 @@ have any parameter descriptions.", "value": "Array", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, Object { "type": "text", @@ -10559,9 +10614,9 @@ have any parameter descriptions.", "value": "Number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "3", + "referenceType": "full", + "type": "linkReference", }, Object { "type": "text", @@ -10656,9 +10711,9 @@ have any parameter descriptions.", "value": "Number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "3", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -10782,9 +10837,9 @@ have any parameter descriptions.", "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "3", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -10855,9 +10910,9 @@ have any parameter descriptions.", "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "3", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -11234,23 +11289,9 @@ as a property.", "value": "sink", }, ], - "jsdoc": true, - "position": Position { - "end": Object { - "column": 40, - "line": 1, - "offset": 39, - }, - "indent": Array [], - "start": Object { - "column": 23, - "line": 1, - "offset": 22, - }, - }, - "title": null, - "type": "link", - "url": "#sink", + "identifier": "4", + "referenceType": "full", + "type": "linkReference", }, Object { "position": Position { @@ -11279,23 +11320,9 @@ It takes a ", "value": "number", }, ], - "jsdoc": true, - "position": Position { - "end": Object { - "column": 26, - "line": 2, - "offset": 93, - }, - "indent": Array [], - "start": Object { - "column": 12, - "line": 2, - "offset": 79, - }, - }, - "title": null, - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "5", + "referenceType": "full", + "type": "linkReference", }, Object { "position": Position { @@ -11347,9 +11374,9 @@ It takes a ", "value": "Sink", }, ], - "href": "#sink", - "type": "link", - "url": "#sink", + "identifier": "6", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -11572,9 +11599,9 @@ It takes a ", "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "3", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -11698,9 +11725,9 @@ It takes a ", "value": "Number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "3", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -12058,9 +12085,9 @@ It takes a ", "value": "Array", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, Object { "type": "text", @@ -12108,9 +12135,9 @@ It takes a ", "value": "Array", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, Object { "type": "text", @@ -12190,9 +12217,9 @@ It takes a ", "value": "boolean", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean", + "identifier": "7", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -12243,9 +12270,9 @@ It takes a ", "value": "boolean", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean", + "identifier": "7", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -12363,9 +12390,9 @@ It takes a ", "value": "boolean", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean", + "identifier": "7", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -12377,6 +12404,48 @@ It takes a ", ], "type": "paragraph", }, + Object { + "identifier": "1", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object", + }, + Object { + "identifier": "2", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", + }, + Object { + "identifier": "3", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + }, + Object { + "identifier": "4", + "title": null, + "type": "definition", + "url": "#sink", + }, + Object { + "identifier": "5", + "title": null, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + }, + Object { + "identifier": "6", + "title": undefined, + "type": "definition", + "url": "#sink", + }, + Object { + "identifier": "7", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean", + }, ], "type": "root", } @@ -13016,9 +13085,9 @@ Object { "value": "string", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -13159,9 +13228,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -13197,9 +13266,9 @@ Object { "value": "Array", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", + "identifier": "3", + "referenceType": "full", + "type": "linkReference", }, Object { "type": "text", @@ -13212,9 +13281,9 @@ Object { "value": "string", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, Object { "type": "text", @@ -13237,6 +13306,24 @@ Object { "ordered": false, "type": "list", }, + Object { + "identifier": "1", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + }, + Object { + "identifier": "2", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + }, + Object { + "identifier": "3", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", + }, ], "type": "root", } @@ -13933,9 +14020,9 @@ Object { "value": "Number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -14087,9 +14174,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -14136,6 +14223,12 @@ Object { ], "type": "paragraph", }, + Object { + "identifier": "1", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + }, ], "type": "root", } @@ -14558,9 +14651,9 @@ Object { "value": "Event", }, ], - "href": "https://developer.mozilla.org/docs/Web/API/Event", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/API/Event", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -14614,6 +14707,12 @@ Object { "ordered": false, "type": "list", }, + Object { + "identifier": "1", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/API/Event", + }, ], "type": "root", } @@ -14998,9 +15097,9 @@ Object { "value": "Number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -15047,6 +15146,12 @@ Object { ], "type": "paragraph", }, + Object { + "identifier": "1", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + }, ], "type": "root", } @@ -15714,9 +15819,9 @@ Object { "value": "area", }, ], - "href": "#area", - "type": "link", - "url": "#area", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -15855,6 +15960,12 @@ Object { "ordered": false, "type": "list", }, + Object { + "identifier": "1", + "title": undefined, + "type": "definition", + "url": "#area", + }, ], "type": "root", } @@ -16331,9 +16442,9 @@ Object { "value": "T", }, ], - "href": "#t", - "type": "link", - "url": "#t", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, Object { "type": "text", @@ -16350,9 +16461,9 @@ Object { "value": "string", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, ], "type": "paragraph", @@ -16419,9 +16530,9 @@ Object { "value": "Array", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", + "identifier": "3", + "referenceType": "full", + "type": "linkReference", }, Object { "type": "text", @@ -16434,9 +16545,9 @@ Object { "value": "string", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, Object { "type": "text", @@ -16465,9 +16576,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "4", + "referenceType": "full", + "type": "linkReference", }, Object { "type": "text", @@ -16542,9 +16653,9 @@ Object { "value": "Array", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", + "identifier": "3", + "referenceType": "full", + "type": "linkReference", }, Object { "type": "text", @@ -16557,9 +16668,9 @@ Object { "value": "string", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, Object { "type": "text", @@ -16588,9 +16699,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "4", + "referenceType": "full", + "type": "linkReference", }, Object { "type": "text", @@ -16599,6 +16710,30 @@ Object { ], "type": "paragraph", }, + Object { + "identifier": "1", + "title": undefined, + "type": "definition", + "url": "#t", + }, + Object { + "identifier": "2", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + }, + Object { + "identifier": "3", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", + }, + Object { + "identifier": "4", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + }, ], "type": "root", } @@ -17944,9 +18079,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -18015,9 +18150,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -18103,23 +18238,9 @@ Object { "value": "addOne", }, ], - "jsdoc": true, - "position": Position { - "end": Object { - "column": 15, - "line": 2, - "offset": 74, - }, - "indent": Array [], - "start": Object { - "column": 1, - "line": 2, - "offset": 60, - }, - }, - "title": null, - "type": "link", - "url": "#addone", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, Object { "position": Position { @@ -18148,23 +18269,9 @@ Object { "value": "Addition", }, ], - "jsdoc": true, - "position": Position { - "end": Object { - "column": 56, - "line": 3, - "offset": 164, - }, - "indent": Array [], - "start": Object { - "column": 1, - "line": 3, - "offset": 109, - }, - }, - "title": null, - "type": "link", - "url": "https://en.wikipedia.org/wiki/Addition", + "identifier": "3", + "referenceType": "full", + "type": "linkReference", }, Object { "position": Position { @@ -18193,23 +18300,9 @@ and ", "value": "https://en.wikipedia.org/wiki/Addition", }, ], - "jsdoc": true, - "position": Position { - "end": Object { - "column": 51, - "line": 4, - "offset": 215, - }, - "indent": Array [], - "start": Object { - "column": 5, - "line": 4, - "offset": 169, - }, - }, - "title": null, - "type": "link", - "url": "https://en.wikipedia.org/wiki/Addition", + "identifier": "3", + "referenceType": "full", + "type": "linkReference", }, ], "position": Position { @@ -18257,23 +18350,9 @@ and ", "value": "nothing", }, ], - "jsdoc": true, - "position": Position { - "end": Object { - "column": 45, - "line": 6, - "offset": 261, - }, - "indent": Array [], - "start": Object { - "column": 30, - "line": 6, - "offset": 246, - }, - }, - "title": null, - "type": "link", - "url": "nothing", + "identifier": "4", + "referenceType": "full", + "type": "linkReference", }, ], "position": Position { @@ -18323,9 +18402,9 @@ and ", "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -18394,9 +18473,9 @@ and ", "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -18443,6 +18522,30 @@ and ", ], "type": "paragraph", }, + Object { + "identifier": "1", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + }, + Object { + "identifier": "2", + "title": null, + "type": "definition", + "url": "#addone", + }, + Object { + "identifier": "3", + "title": null, + "type": "definition", + "url": "https://en.wikipedia.org/wiki/Addition", + }, + Object { + "identifier": "4", + "title": null, + "type": "definition", + "url": "nothing", + }, ], "type": "root", } @@ -18687,9 +18790,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -18725,9 +18828,9 @@ Object { "value": "string", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -18746,6 +18849,18 @@ Object { "ordered": false, "type": "list", }, + Object { + "identifier": "1", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + }, + Object { + "identifier": "2", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + }, ], "type": "root", } @@ -19767,9 +19882,9 @@ Object { "value": "string", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -19838,9 +19953,9 @@ Object { "value": "string", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -19964,9 +20079,9 @@ Object { "value": "string", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -20035,9 +20150,9 @@ Object { "value": "string", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -20084,6 +20199,12 @@ Object { ], "type": "paragraph", }, + Object { + "identifier": "1", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + }, ], "type": "root", } @@ -21211,9 +21332,9 @@ Object { "value": "boolean", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -21282,9 +21403,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -21391,9 +21512,9 @@ Object { "value": "undefined", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined", + "identifier": "3", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -21440,6 +21561,24 @@ Object { ], "type": "paragraph", }, + Object { + "identifier": "1", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean", + }, + Object { + "identifier": "2", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + }, + Object { + "identifier": "3", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined", + }, ], "type": "root", } @@ -21842,9 +21981,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -21913,9 +22052,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -21962,6 +22101,12 @@ Object { ], "type": "paragraph", }, + Object { + "identifier": "1", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + }, ], "type": "root", } @@ -22462,23 +22607,9 @@ Object { "value": "github", }, ], - "jsdoc": true, - "position": Position { - "end": Object { - "column": 34, - "line": 1, - "offset": 33, - }, - "indent": Array [], - "start": Object { - "column": 1, - "line": 1, - "offset": 0, - }, - }, - "title": null, - "type": "link", - "url": "http://github.com/", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "position": Position { @@ -22581,22 +22712,9 @@ Object { "value": "markdown link", }, ], - "position": Position { - "end": Object { - "column": 33, - "line": 1, - "offset": 32, - }, - "indent": Array [], - "start": Object { - "column": 1, - "line": 1, - "offset": 0, - }, - }, - "title": null, - "type": "link", - "url": "http://foo.com/", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, ], "position": Position { @@ -22674,9 +22792,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "3", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -22894,6 +23012,24 @@ Object { "ordered": false, "type": "list", }, + Object { + "identifier": "1", + "title": null, + "type": "definition", + "url": "http://github.com/", + }, + Object { + "identifier": "2", + "title": null, + "type": "definition", + "url": "http://foo.com/", + }, + Object { + "identifier": "3", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + }, ], "type": "root", } @@ -23430,9 +23566,9 @@ Object { "value": "Date", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Date", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Date", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -23556,9 +23692,9 @@ Object { "value": "Date", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Date", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Date", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -23627,9 +23763,9 @@ Object { "value": "undefined", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -23676,6 +23812,18 @@ Object { ], "type": "paragraph", }, + Object { + "identifier": "1", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Date", + }, + Object { + "identifier": "2", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined", + }, ], "type": "root", } @@ -24299,9 +24447,9 @@ Object { "value": "object", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -24336,9 +24484,9 @@ Object { "value": "string", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -24477,9 +24625,9 @@ Object { "value": "string", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -24557,9 +24705,9 @@ Object { "value": "function", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function", + "identifier": "3", + "referenceType": "full", + "type": "linkReference", }, Object { "type": "text", @@ -24666,9 +24814,9 @@ Object { "value": "Promise", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise", + "identifier": "4", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -24715,6 +24863,30 @@ Object { ], "type": "paragraph", }, + Object { + "identifier": "1", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object", + }, + Object { + "identifier": "2", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + }, + Object { + "identifier": "3", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function", + }, + Object { + "identifier": "4", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise", + }, ], "type": "root", } @@ -25610,9 +25782,9 @@ Object { "value": "Array", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, Object { "type": "text", @@ -25625,9 +25797,9 @@ Object { "value": "Object", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, Object { "type": "text", @@ -25701,9 +25873,9 @@ Object { "value": "string", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + "identifier": "3", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -25774,9 +25946,9 @@ Object { "value": "string", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + "identifier": "3", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -25854,9 +26026,9 @@ Object { "value": "string", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + "identifier": "3", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -25969,9 +26141,9 @@ Object { "value": "Object", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -26041,9 +26213,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "4", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -26121,9 +26293,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "4", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -26209,9 +26381,9 @@ Object { "value": "Object", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -26281,9 +26453,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "4", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -26319,9 +26491,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "4", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -26357,9 +26529,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "4", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -26400,9 +26572,9 @@ Object { "value": "Object", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -26449,6 +26621,30 @@ Object { ], "type": "paragraph", }, + Object { + "identifier": "1", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", + }, + Object { + "identifier": "2", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object", + }, + Object { + "identifier": "3", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + }, + Object { + "identifier": "4", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + }, ], "type": "root", } @@ -26727,9 +26923,9 @@ Object { "value": "Number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -26791,6 +26987,12 @@ still work in the markdown table.", "ordered": false, "type": "list", }, + Object { + "identifier": "1", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + }, ], "type": "root", } @@ -27007,9 +27209,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -27028,6 +27230,12 @@ Object { "ordered": false, "type": "list", }, + Object { + "identifier": "1", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + }, ], "type": "root", } @@ -27175,9 +27383,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, Object { "type": "text", @@ -27198,9 +27406,9 @@ Object { "value": "string", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, Object { "type": "text", @@ -27241,9 +27449,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, Object { "type": "text", @@ -27283,9 +27491,9 @@ Object { "value": "string", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -27304,6 +27512,18 @@ Object { "ordered": false, "type": "list", }, + Object { + "identifier": "1", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + }, + Object { + "identifier": "2", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + }, ], "type": "root", } @@ -30253,9 +30473,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -30348,9 +30568,9 @@ Object { "value": "Object", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -30518,9 +30738,9 @@ Object { "value": "Object", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -30555,9 +30775,9 @@ Object { "value": "String", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + "identifier": "3", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -30717,9 +30937,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -30877,9 +31097,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -31172,9 +31392,9 @@ Object { "value": "string", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + "identifier": "3", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -31245,9 +31465,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -31335,9 +31555,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, Object { "type": "text", @@ -31412,9 +31632,9 @@ Object { "value": "Array", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", + "identifier": "4", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -31611,9 +31831,9 @@ Object { "value": "Object", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, Object { "type": "text", @@ -31691,9 +31911,9 @@ Object { "value": "Object", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, Object { "type": "text", @@ -31706,9 +31926,9 @@ Object { "value": "string", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + "identifier": "3", + "referenceType": "full", + "type": "linkReference", }, Object { "type": "text", @@ -31788,9 +32008,9 @@ The latter is preferable in case of large GeoJSON files.", "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -31878,9 +32098,9 @@ The latter is preferable in case of large GeoJSON files.", "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, Object { "type": "text", @@ -31955,9 +32175,9 @@ The latter is preferable in case of large GeoJSON files.", "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, Object { "type": "text", @@ -32104,9 +32324,9 @@ values specified in code.", "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -32192,9 +32412,9 @@ values specified in code.", "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -32445,9 +32665,9 @@ iterator destructure (RestElement)", "value": "Array", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", + "identifier": "4", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -32623,9 +32843,9 @@ iterator destructure (RestElement)", "value": "Array", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", + "identifier": "4", + "referenceType": "full", + "type": "linkReference", }, Object { "type": "text", @@ -32684,6 +32904,30 @@ iterator destructure (RestElement)", ], "type": "paragraph", }, + Object { + "identifier": "1", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + }, + Object { + "identifier": "2", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object", + }, + Object { + "identifier": "3", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + }, + Object { + "identifier": "4", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", + }, ], "type": "root", } @@ -34395,9 +34639,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -34444,6 +34688,12 @@ Object { ], "type": "paragraph", }, + Object { + "identifier": "1", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + }, ], "type": "root", } @@ -35059,9 +35309,9 @@ plus 3.", "value": "Number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -35132,9 +35382,9 @@ plus 3.", "value": "simpleCallback", }, ], - "href": "#simplecallback", - "type": "link", - "url": "#simplecallback", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -35246,9 +35496,9 @@ plus 3.", "value": "Function", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function", + "identifier": "3", + "referenceType": "full", + "type": "linkReference", }, ], "type": "paragraph", @@ -35285,9 +35535,9 @@ plus 3.", "value": "Error", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Error", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Error", + "identifier": "4", + "referenceType": "full", + "type": "linkReference", }, Object { "type": "text", @@ -35362,9 +35612,9 @@ plus 3.", "value": "Number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -35418,6 +35668,30 @@ plus 3.", "ordered": false, "type": "list", }, + Object { + "identifier": "1", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + }, + Object { + "identifier": "2", + "title": undefined, + "type": "definition", + "url": "#simplecallback", + }, + Object { + "identifier": "3", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function", + }, + Object { + "identifier": "4", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Error", + }, ], "type": "root", } @@ -35669,9 +35943,9 @@ Object { "value": "Number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -35718,6 +35992,12 @@ Object { ], "type": "paragraph", }, + Object { + "identifier": "1", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + }, ], "type": "root", } @@ -36117,9 +36397,9 @@ Object { "value": "Number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -36203,9 +36483,9 @@ Object { "value": "Number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -36252,6 +36532,12 @@ Object { ], "type": "paragraph", }, + Object { + "identifier": "1", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + }, ], "type": "root", } @@ -37553,9 +37839,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -37602,6 +37888,12 @@ Object { ], "type": "paragraph", }, + Object { + "identifier": "1", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + }, ], "type": "root", } @@ -38514,9 +38806,9 @@ Object { "value": "Array", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, Object { "type": "text", @@ -38529,9 +38821,9 @@ Object { "value": "string", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, Object { "type": "text", @@ -38589,6 +38881,18 @@ Object { "ordered": false, "type": "list", }, + Object { + "identifier": "1", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array", + }, + Object { + "identifier": "2", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String", + }, ], "type": "root", } @@ -38719,9 +39023,9 @@ Object { "value": "number", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + "identifier": "1", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -38755,9 +39059,9 @@ Object { "value": "boolean", }, ], - "href": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean", - "type": "link", - "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean", + "identifier": "2", + "referenceType": "full", + "type": "linkReference", }, ], "type": "strong", @@ -38769,6 +39073,18 @@ Object { ], "type": "paragraph", }, + Object { + "identifier": "1", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number", + }, + Object { + "identifier": "2", + "title": undefined, + "type": "definition", + "url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean", + }, ], "type": "root", } diff --git a/__tests__/utils.js b/__tests__/utils.js index 5e7675fb3..874093df1 100644 --- a/__tests__/utils.js +++ b/__tests__/utils.js @@ -25,7 +25,10 @@ function normalize(comments) { loc: comment.context.loc }; if (hasGithub) { - comment.context.github = '[github]'; + comment.context.github = { + path: '[github]', + url: '[github]' + }; } if (path) { comment.context.path = path; diff --git a/declarations/comment.js b/declarations/comment.js index 24fb5ba64..c901cb3dd 100644 --- a/declarations/comment.js +++ b/declarations/comment.js @@ -11,7 +11,8 @@ type DocumentationConfig = { external?: Array, theme: string, requireExtension?: Array, - parseExtension: Array + parseExtension: Array, + noReferenceLinks?: boolean }; type CommentError = { diff --git a/docs/NODE_API.md b/docs/NODE_API.md index d5d13c249..275a423fe 100644 --- a/docs/NODE_API.md +++ b/docs/NODE_API.md @@ -2,12 +2,12 @@ ### Table of Contents -- [lint](#lint) -- [build](#build) -- [formats](#formats) -- [formats.html](#formatshtml) -- [formats.markdown](#formatsmarkdown) -- [formats.json](#formatsjson) +- [lint][1] +- [build][2] +- [formats][3] +- [formats.html][4] +- [formats.markdown][5] +- [formats.json][6] ## lint @@ -17,18 +17,18 @@ of lint information intended for human-readable output. **Parameters** -- `indexes` **([Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)> | [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String))** files to process -- `args` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** args - - `args.external` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>** a string regex / glob match pattern +- `indexes` **([Array][7]<[string][8]> | [string][8])** files to process +- `args` **[Object][9]** args + - `args.external` **[Array][7]<[string][8]>** a string regex / glob match pattern that defines what external modules will be whitelisted and included in the generated documentation. - - `args.shallow` **[boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)** whether to avoid dependency parsing + - `args.shallow` **[boolean][10]** whether to avoid dependency parsing even in JavaScript code. (optional, default `false`) - - `args.inferPrivate` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)?** a valid regular expression string + - `args.inferPrivate` **[string][8]?** a valid regular expression string to infer whether a code element should be private, given its naming structure. For instance, you can specify `inferPrivate: '^_'` to automatically treat methods named like `_myMethod` as private. - - `args.extension` **([string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) \| [Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>)?** treat additional file extensions + - `args.extension` **([string][8] \| [Array][7]<[string][8]>)?** treat additional file extensions as JavaScript, extending the default set of `js`, `es6`, and `jsx`. **Examples** @@ -44,7 +44,7 @@ documentation.lint('file.js').then(lintOutput => { }); ``` -Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)** promise with lint results +Returns **[Promise][11]** promise with lint results ## build @@ -53,25 +53,25 @@ comments, given a root file as a path. **Parameters** -- `indexes` **([Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)> | [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String))** files to process -- `args` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** args - - `args.external` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>** a string regex / glob match pattern +- `indexes` **([Array][7]<[string][8]> | [string][8])** files to process +- `args` **[Object][9]** args + - `args.external` **[Array][7]<[string][8]>** a string regex / glob match pattern that defines what external modules will be whitelisted and included in the generated documentation. - - `args.shallow` **[boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)** whether to avoid dependency parsing + - `args.shallow` **[boolean][10]** whether to avoid dependency parsing even in JavaScript code. (optional, default `false`) - - `args.order` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<([string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) \| [Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object))>** optional array that + - `args.order` **[Array][7]<([string][8] \| [Object][9])>** optional array that defines sorting order of documentation (optional, default `[]`) - - `args.access` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>** an array of access levels + - `args.access` **[Array][7]<[string][8]>** an array of access levels to output in documentation (optional, default `[]`) - - `args.hljs` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)?** hljs optional args - - `args.hljs.highlightAuto` **[boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)** hljs automatically detect language (optional, default `false`) - - `args.hljs.languages` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)?** languages for hljs to choose from - - `args.inferPrivate` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)?** a valid regular expression string + - `args.hljs` **[Object][9]?** hljs optional args + - `args.hljs.highlightAuto` **[boolean][10]** hljs automatically detect language (optional, default `false`) + - `args.hljs.languages` **[Array][7]?** languages for hljs to choose from + - `args.inferPrivate` **[string][8]?** a valid regular expression string to infer whether a code element should be private, given its naming structure. For instance, you can specify `inferPrivate: '^_'` to automatically treat methods named like `_myMethod` as private. - - `args.extension` **([string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) \| [Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>)?** treat additional file extensions + - `args.extension` **([string][8] \| [Array][7]<[string][8]>)?** treat additional file extensions as JavaScript, extending the default set of `js`, `es6`, and `jsx`. **Examples** @@ -89,7 +89,7 @@ documentation.build(['index.js'], { }); ``` -Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)** results +Returns **[Promise][11]** results ## formats @@ -104,9 +104,9 @@ Formats documentation as HTML. **Parameters** -- `comments` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[Comment](https://developer.mozilla.org/docs/Web/API/Comment/Comment)>** parsed comments -- `config` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** Options that can customize the output - - `config.theme` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** Name of a module used for an HTML theme. (optional, default `'default_theme'`) +- `comments` **[Array][7]<[Comment][12]>** parsed comments +- `config` **[Object][9]** Options that can customize the output + - `config.theme` **[string][8]** Name of a module used for an HTML theme. (optional, default `'default_theme'`) **Examples** @@ -122,17 +122,17 @@ documentation.build(['index.js']) }); ``` -Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)>>** Promise with results +Returns **[Promise][11]<[Array][7]<[Object][9]>>** Promise with results ## formats.markdown Formats documentation as -[Markdown](http://daringfireball.net/projects/markdown/). +[Markdown][13]. **Parameters** -- `comments` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)>** parsed comments -- `args` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** Options that can customize the output +- `comments` **[Array][7]<[Object][9]>** parsed comments +- `args` **[Object][9]** Options that can customize the output **Examples** @@ -148,7 +148,7 @@ documentation.build(['index.js']) }); ``` -Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>** a promise of the eventual value +Returns **[Promise][11]<[string][8]>** a promise of the eventual value ## formats.json @@ -156,7 +156,7 @@ Formats documentation as a JSON string. **Parameters** -- `comments` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[Comment](https://developer.mozilla.org/docs/Web/API/Comment/Comment)>** parsed comments +- `comments` **[Array][7]<[Comment][12]>** parsed comments **Examples** @@ -172,4 +172,30 @@ documentation.build(['index.js']) }); ``` -Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>** +Returns **[Promise][11]<[string][8]>** + +[1]: #lint + +[2]: #build + +[3]: #formats + +[4]: #formatshtml + +[5]: #formatsmarkdown + +[6]: #formatsjson + +[7]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array + +[8]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String + +[9]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object + +[10]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean + +[11]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise + +[12]: https://developer.mozilla.org/docs/Web/API/Comment/Comment + +[13]: http://daringfireball.net/projects/markdown/ diff --git a/package.json b/package.json index d5afc1ccc..97cafa49d 100644 --- a/package.json +++ b/package.json @@ -41,6 +41,7 @@ "read-pkg-up": "^3.0.0", "remark": "^9.0.0", "remark-html": "7.0.0", + "remark-reference-links": "^4.0.1", "remark-toc": "^5.0.0", "remote-origin-url": "0.4.0", "shelljs": "^0.8.1", @@ -103,7 +104,7 @@ "release": "standard-version", "precommit": "lint-staged", "prepublish": "npm run build", - "format": "prettier --write '{src,__tests__,declarations,bin,default_theme}/**/*.js' --single-quote", + "format": "prettier --write '{src,__tests__,declarations,bin,default_theme}/**/*.js'", "doc": "node ./bin/documentation.js build src/index.js -f md --access=public > docs/NODE_API.md", "self-lint": "node ./bin/documentation.js lint src", "test": "npm run build && eslint . && are-we-flow-yet src && flow check && jest", @@ -131,7 +132,7 @@ }, "lint-staged": { "*.js": [ - "prettier --write --single-quote", + "prettier --write", "git add" ] }, diff --git a/src/commands/readme.js b/src/commands/readme.js index c2914e46f..3a2a4eca7 100644 --- a/src/commands/readme.js +++ b/src/commands/readme.js @@ -70,6 +70,7 @@ module.exports.handler = function readme(argv: Object) { } } + argv.noReferenceLinks = true; argv.format = 'remark'; /* eslint no-console: 0 */ const log: Function = (...data: Array) => { diff --git a/src/output/markdown_ast.js b/src/output/markdown_ast.js index f479e6952..5efa3f61c 100644 --- a/src/output/markdown_ast.js +++ b/src/output/markdown_ast.js @@ -4,6 +4,7 @@ const u = require('unist-builder'); const remark = require('remark'); const mergeConfig = require('../merge_config'); const toc = require('remark-toc'); +const links = require('remark-reference-links'); const hljs = require('highlight.js'); const GithubSlugger = require('github-slugger'); const LinkerStack = require('./util/linker_stack'); @@ -374,11 +375,10 @@ function buildMarkdownAST( ) ); - if (config.markdownToc) { - root = remark() - .use(toc, { tight: true }) - .run(root); - } + const pluginRemark = remark(); + if (config.markdownToc) pluginRemark.use(toc, { tight: true }); + if (config.noReferenceLinks !== true) pluginRemark.use(links); + root = pluginRemark.run(root); return Promise.resolve(root); } diff --git a/yarn.lock b/yarn.lock index a2f0d8ce2..f671a5dea 100644 --- a/yarn.lock +++ b/yarn.lock @@ -5030,6 +5030,12 @@ remark-parse@^5.0.0: vfile-location "^2.0.0" xtend "^4.0.1" +remark-reference-links@^4.0.1: + version "4.0.1" + resolved "https://registry.yarnpkg.com/remark-reference-links/-/remark-reference-links-4.0.1.tgz#021aed1c55c187d712b3c76d0057bf510d300ba7" + dependencies: + unist-util-visit "^1.0.0" + remark-slug@^5.0.0: version "5.0.0" resolved "https://registry.yarnpkg.com/remark-slug/-/remark-slug-5.0.0.tgz#9de71fcdc2bfae33ebb4a41eb83035288a829980"