1 | # Changelog
|
2 |
|
3 | All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
|
4 |
|
5 | ## [14.0.0](https://github.com/documentationjs/documentation/compare/v14.0.0-alpha.1...v14.0.0) (2022-08-19)
|
6 |
|
7 | ## [14.0.0-alpha.1](https://github.com/documentationjs/documentation/compare/v14.0.0-alpha.0...v14.0.0-alpha.1) (2022-08-07)
|
8 |
|
9 |
|
10 | ### Features
|
11 |
|
12 | * :sparkles: update Babel, copy list of plugins from Prettier ([3f187d7](https://github.com/documentationjs/documentation/commit/3f187d73132c6667a9140bd491c5f703c1f37c40))
|
13 |
|
14 | ## [14.0.0-alpha.0](https://github.com/documentationjs/documentation/compare/v13.2.5...v14.0.0-alpha.0) (2022-08-05)
|
15 |
|
16 |
|
17 | ### ⚠ BREAKING CHANGES
|
18 |
|
19 | * all Extensions whould contains '.' so that mean if you have just 'ts' then need to convert to '.ts'
|
20 | * external parameter was removed
|
21 | Migration plan propose to move all external resources to input usages
|
22 | Motivation: packages has many inputs which describe in package.json
|
23 | so that mean need each time to parse all package.json of exsternal resources to understand which etry point need to pick.
|
24 | But it is base on guesses because entry point may could not contains a documentation and the best way to handle it manualy.
|
25 | * The serve parametr was remove, you can use any other tools which could be refresh and store your html site
|
26 | The private parameter has removed, use a access
|
27 | * documentation.js will now require node 14 or later.
|
28 |
|
29 | ### Bug Fixes
|
30 |
|
31 | * add micromark dependencies fixed [#1381](https://github.com/documentationjs/documentation/issues/1381) ([3ba8165](https://github.com/documentationjs/documentation/commit/3ba81659d7db5d9393fa083287d91db93d6aab5e))
|
32 | * add TS and TSX as default extensions fixed [#1377](https://github.com/documentationjs/documentation/issues/1377) ([f0cb1c0](https://github.com/documentationjs/documentation/commit/f0cb1c0bb1d97228c7baab453e50e5dbe283ea46))
|
33 | * external was removed as prefer of input usages ([e3c59d7](https://github.com/documentationjs/documentation/commit/e3c59d77e4e3cf6e5fabab7c0d853a06a77f6288))
|
34 | * html report, it is return html if output is not defined ([0975871](https://github.com/documentationjs/documentation/commit/0975871b34b8cc0af74e0aebb43f2727e0ab9960))
|
35 | * remove private parameter, use access (BREAKING CHANGES) ([874069c](https://github.com/documentationjs/documentation/commit/874069c0b3647dad413667f61d05f6d39992995d))
|
36 | * The server parameter deprecated and will be remove in next Major version fixed [#1413](https://github.com/documentationjs/documentation/issues/1413) ([810e08b](https://github.com/documentationjs/documentation/commit/810e08b6fdb1076a1758bff831a9f42890f0f25f))
|
37 | * use process.cwd vs `.` which can fail ([4cc70a5](https://github.com/documentationjs/documentation/commit/4cc70a5aed0c233cdcc72077733f9da8450be386))
|
38 |
|
39 |
|
40 | * replace module-deps-sortable on own implementation to control how parse files ([abb781a](https://github.com/documentationjs/documentation/commit/abb781a69ac69423da11346f62d7064382bb7b74))
|
41 | * Update Node minimum version to 14 ([fc0bb3c](https://github.com/documentationjs/documentation/commit/fc0bb3cd885b9577e6f1f6935e15d4ec24f89114))
|
42 |
|
43 | ### [13.2.5](https://github.com/documentationjs/documentation/compare/v13.2.4...v13.2.5) (2021-04-24)
|
44 |
|
45 |
|
46 | ### Bug Fixes
|
47 |
|
48 | * add gfm format for remark fixed [#1374](https://github.com/documentationjs/documentation/issues/1374) ([#1375](https://github.com/documentationjs/documentation/issues/1375)) ([6b5bc25](https://github.com/documentationjs/documentation/commit/6b5bc2548db23fdab3fd8d29ac1aeedea7ad3a47))
|
49 | * jsx should be included for tsx files but not for ts fixed [#1359](https://github.com/documentationjs/documentation/issues/1359) ([#1373](https://github.com/documentationjs/documentation/issues/1373)) ([00d434f](https://github.com/documentationjs/documentation/commit/00d434f8576969b00d53a20efebb52a880acf350))
|
50 |
|
51 | ### [13.2.4](https://github.com/documentationjs/documentation/compare/v13.2.3...v13.2.4) (2021-04-21)
|
52 |
|
53 |
|
54 | ### Bug Fixes
|
55 |
|
56 | * add support Vue 3 fixed [#1339](https://github.com/documentationjs/documentation/issues/1339) ([#1372](https://github.com/documentationjs/documentation/issues/1372)) ([cd7d123](https://github.com/documentationjs/documentation/commit/cd7d12366cc499ae8d40a64905354c3479f802f6))
|
57 |
|
58 | ### [13.2.3](https://github.com/documentationjs/documentation/compare/v13.2.2...v13.2.3) (2021-04-20)
|
59 |
|
60 | ### [13.2.2](https://github.com/documentationjs/documentation/compare/v13.2.1...v13.2.2) (2021-04-20)
|
61 |
|
62 |
|
63 | ### Bug Fixes
|
64 |
|
65 | * [@see](https://github.com/see) tags incorrectly formatted in markdown ouput fixed [#1337](https://github.com/documentationjs/documentation/issues/1337) ([5d8d450](https://github.com/documentationjs/documentation/commit/5d8d4504d52a5bb0a0432bf399bbd82d9e5ea7fc))
|
66 |
|
67 | ### [13.2.1](https://github.com/documentationjs/documentation/compare/v13.2.0...v13.2.1) (2021-04-06)
|
68 |
|
69 | ## [13.2.0](https://github.com/documentationjs/documentation/compare/v13.1.1...v13.2.0) (2021-03-13)
|
70 |
|
71 |
|
72 | ### Features
|
73 |
|
74 | * Support import.meta ([d449e7c](https://github.com/documentationjs/documentation/commit/d449e7c3ca0abb7379ea4159b0ef0281059077eb)), closes [#1345](https://github.com/documentationjs/documentation/issues/1345)
|
75 |
|
76 | ### [13.1.1](https://github.com/documentationjs/documentation/compare/v13.1.0...v13.1.1) (2021-01-19)
|
77 |
|
78 | ## [13.1.0](https://github.com/documentationjs/documentation/compare/v13.0.2...v13.1.0) (2020-10-24)
|
79 |
|
80 |
|
81 | ### Features
|
82 |
|
83 | * Add event members to md output ([#1336](https://github.com/documentationjs/documentation/issues/1336)) ([bc3233f](https://github.com/documentationjs/documentation/commit/bc3233fe7e414e65756cf50450ebad069e37506a))
|
84 |
|
85 | ### [13.0.2](https://github.com/documentationjs/documentation/compare/v13.0.1...v13.0.2) (2020-07-02)
|
86 |
|
87 |
|
88 | ### Bug Fixes
|
89 |
|
90 | * Additional safety around detecting functions in HTML output ([a8b6ce1](https://github.com/documentationjs/documentation/commit/a8b6ce144ea380ad21ba99f03574f6258be10666))
|
91 |
|
92 | ### [13.0.1](https://github.com/documentationjs/documentation/compare/v13.0.0...v13.0.1) (2020-06-04)
|
93 |
|
94 |
|
95 | ### Bug Fixes
|
96 |
|
97 | * 🐛 Error with flow opaque type and readme command ([78db9a4](https://github.com/documentationjs/documentation/commit/78db9a443a65bbe8ff202083351655e0cfa60004)), closes [#1322](https://github.com/documentationjs/documentation/issues/1322)
|
98 | * 🐛 Fixes an issue when using object spread and $Exact ([106945c](https://github.com/documentationjs/documentation/commit/106945c6354f0b70335adf737c7b7fa296952cc3)), closes [#1324](https://github.com/documentationjs/documentation/issues/1324)
|
99 |
|
100 | <a name="13.0.0"></a>
|
101 | # [13.0.0](https://github.com/documentationjs/documentation/compare/v12.3.0...v13.0.0) (2020-05-09)
|
102 |
|
103 |
|
104 | ### Chores
|
105 |
|
106 | * Update Node minimum version to 10 ([45a5257](https://github.com/documentationjs/documentation/commit/45a5257))
|
107 |
|
108 |
|
109 | ### BREAKING CHANGES
|
110 |
|
111 | * documentation.js will now require node 10 or later.
|
112 |
|
113 |
|
114 |
|
115 | <a name="12.3.0"></a>
|
116 | # [12.3.0](https://github.com/documentationjs/documentation/compare/v12.2.0...v12.3.0) (2020-04-07)
|
117 |
|
118 |
|
119 | ### Features
|
120 |
|
121 | * upgrade babel dependencies ([d0ec029](https://github.com/documentationjs/documentation/commit/d0ec029))
|
122 |
|
123 |
|
124 |
|
125 | <a name="12.2.0"></a>
|
126 | # [12.2.0](https://github.com/documentationjs/documentation/compare/v12.1.4...v12.2.0) (2020-03-31)
|
127 |
|
128 |
|
129 | ### Features
|
130 |
|
131 | * support for the [@see](https://github.com/see) tag in Markdown & HTML ([48bb7a2](https://github.com/documentationjs/documentation/commit/48bb7a2))
|
132 |
|
133 |
|
134 |
|
135 | <a name="12.1.4"></a>
|
136 | ## [12.1.4](https://github.com/documentationjs/documentation/compare/v12.1.3...v12.1.4) (2019-11-15)
|
137 |
|
138 |
|
139 |
|
140 | <a name="12.1.3"></a>
|
141 | ## [12.1.3](https://github.com/documentationjs/documentation/compare/v12.1.2...v12.1.3) (2019-11-04)
|
142 |
|
143 |
|
144 | ### Bug Fixes
|
145 |
|
146 | * upgrade git-url-parse to fix a parsing issue ([#1296](https://github.com/documentationjs/documentation/issues/1296)) ([344e804](https://github.com/documentationjs/documentation/commit/344e804))
|
147 |
|
148 |
|
149 |
|
150 | <a name="12.1.2"></a>
|
151 | ## [12.1.2](https://github.com/documentationjs/documentation/compare/v12.1.1...v12.1.2) (2019-09-09)
|
152 |
|
153 |
|
154 | ### Bug Fixes
|
155 |
|
156 | * check for empty diff ([#1273](https://github.com/documentationjs/documentation/issues/1273)) ([3e0958b](https://github.com/documentationjs/documentation/commit/3e0958b))
|
157 |
|
158 |
|
159 |
|
160 | <a name="12.1.1"></a>
|
161 | ## [12.1.1](https://github.com/documentationjs/documentation/compare/v12.1.0...v12.1.1) (2019-08-01)
|
162 |
|
163 |
|
164 | ### Bug Fixes
|
165 |
|
166 | * Git submodule support for repo names with a dot ([#1271](https://github.com/documentationjs/documentation/issues/1271)) ([27a29be](https://github.com/documentationjs/documentation/commit/27a29be))
|
167 |
|
168 |
|
169 |
|
170 | <a name="12.1.0"></a>
|
171 | # [12.1.0](https://github.com/documentationjs/documentation/compare/v12.0.3...v12.1.0) (2019-07-31)
|
172 |
|
173 |
|
174 | ### Features
|
175 |
|
176 | * Add git submodules support to github linking ([#1270](https://github.com/documentationjs/documentation/issues/1270)) ([ec36b41](https://github.com/documentationjs/documentation/commit/ec36b41))
|
177 |
|
178 |
|
179 |
|
180 | <a name="12.0.3"></a>
|
181 | ## [12.0.3](https://github.com/documentationjs/documentation/compare/v12.0.2...v12.0.3) (2019-07-22)
|
182 |
|
183 |
|
184 | ### Bug Fixes
|
185 |
|
186 | * Allow skipped array arguments in destructuring. Fixes [#1247](https://github.com/documentationjs/documentation/issues/1247) ([#1266](https://github.com/documentationjs/documentation/issues/1266)) ([f9039e9](https://github.com/documentationjs/documentation/commit/f9039e9))
|
187 |
|
188 |
|
189 |
|
190 | <a name="12.0.2"></a>
|
191 | ## [12.0.2](https://github.com/documentationjs/documentation/compare/v12.0.1...v12.0.2) (2019-07-16)
|
192 |
|
193 |
|
194 |
|
195 | <a name="12.0.1"></a>
|
196 | ## [12.0.1](https://github.com/documentationjs/documentation/compare/v12.0.0...v12.0.1) (2019-07-10)
|
197 |
|
198 |
|
199 | ### Bug Fixes
|
200 |
|
201 | * Crash when called with no inputs. yargs now variadic positional arguments undefined instead of [] ([821a15e](https://github.com/documentationjs/documentation/commit/821a15e))
|
202 |
|
203 |
|
204 |
|
205 | <a name="12.0.0"></a>
|
206 | # [12.0.0](https://github.com/documentationjs/documentation/compare/v11.0.1...v12.0.0) (2019-07-10)
|
207 |
|
208 |
|
209 | * Formatted with Prettier ([8f36e75](https://github.com/documentationjs/documentation/commit/8f36e75))
|
210 |
|
211 |
|
212 | ### BREAKING CHANGES
|
213 |
|
214 | * The next release will require Node 8
|
215 |
|
216 |
|
217 |
|
218 | <a name="11.0.1"></a>
|
219 | ## [11.0.1](https://github.com/documentationjs/documentation/compare/v11.0.0...v11.0.1) (2019-06-12)
|
220 |
|
221 |
|
222 | ### Bug Fixes
|
223 |
|
224 | * toc with children getting displayed as "note" ([#1253](https://github.com/documentationjs/documentation/issues/1253)) ([14298bb](https://github.com/documentationjs/documentation/commit/14298bb))
|
225 |
|
226 |
|
227 |
|
228 | <a name="11.0.0"></a>
|
229 | # [11.0.0](https://github.com/documentationjs/documentation/compare/v10.1.0...v11.0.0) (2019-05-08)
|
230 |
|
231 |
|
232 | ### Bug Fixes
|
233 |
|
234 | * Fix parsing of optional parameters with annotations ([ca17de5](https://github.com/documentationjs/documentation/commit/ca17de5))
|
235 |
|
236 |
|
237 | ### Features
|
238 |
|
239 | * Enable all parser plugins ([fa1b0b5](https://github.com/documentationjs/documentation/commit/fa1b0b5))
|
240 | * Support exportNamespaceFrom in parser ([8fa141d](https://github.com/documentationjs/documentation/commit/8fa141d))
|
241 |
|
242 |
|
243 | ### BREAKING CHANGES
|
244 |
|
245 | * this removes support for legacy decorators, because
|
246 | in one place we had legacy and in another we didn't.
|
247 |
|
248 |
|
249 |
|
250 | <a name="10.1.0"></a>
|
251 | # [10.1.0](https://github.com/documentationjs/documentation/compare/v10.0.0...v10.1.0) (2019-04-25)
|
252 |
|
253 |
|
254 | ### Features
|
255 |
|
256 | * TypeScript support & inference ([3773e02](https://github.com/documentationjs/documentation/commit/3773e02))
|
257 |
|
258 |
|
259 |
|
260 | <a name="10.0.0"></a>
|
261 | # [10.0.0](https://github.com/documentationjs/documentation/compare/v10.0.0-alpha.0...v10.0.0) (2019-04-18)
|
262 |
|
263 |
|
264 | ### Features
|
265 |
|
266 | * Add flow inference for generators ([7947e97](https://github.com/documentationjs/documentation/commit/7947e97))
|
267 | * Support async functions ([d31c3b7](https://github.com/documentationjs/documentation/commit/d31c3b7))
|
268 | * Support classPrivateProperties in parser ([64ef671](https://github.com/documentationjs/documentation/commit/64ef671)), closes [#1216](https://github.com/documentationjs/documentation/issues/1216)
|
269 | * Support generator functions ([8e3cd47](https://github.com/documentationjs/documentation/commit/8e3cd47))
|
270 |
|
271 |
|
272 |
|
273 | <a name="10.0.0-alpha.0"></a>
|
274 | # [10.0.0-alpha.0](https://github.com/documentationjs/documentation/compare/v9.3.1...v10.0.0-alpha.0) (2019-03-12)
|
275 |
|
276 |
|
277 | ### Features
|
278 |
|
279 | * Support custom babel config ([#1205](https://github.com/documentationjs/documentation/issues/1205)) ([746d0a9](https://github.com/documentationjs/documentation/commit/746d0a9))
|
280 |
|
281 |
|
282 | ### BREAKING CHANGES
|
283 |
|
284 | * this may change babel configuration loading, and is a
|
285 | major change to the documentation.js approach to Babel.
|
286 |
|
287 |
|
288 |
|
289 | <a name="9.3.1"></a>
|
290 | ## [9.3.1](https://github.com/documentationjs/documentation/compare/v9.3.0...v9.3.1) (2019-03-12)
|
291 |
|
292 |
|
293 |
|
294 | <a name="9.3.0"></a>
|
295 | # [9.3.0](https://github.com/documentationjs/documentation/compare/v9.2.1...v9.3.0) (2019-02-27)
|
296 |
|
297 |
|
298 | ### Features
|
299 |
|
300 | * Add inner section ([#1212](https://github.com/documentationjs/documentation/issues/1212)) ([64c9ca6](https://github.com/documentationjs/documentation/commit/64c9ca6))
|
301 |
|
302 |
|
303 |
|
304 | <a name="9.2.1"></a>
|
305 | ## [9.2.1](https://github.com/documentationjs/documentation/compare/v9.2.0...v9.2.1) (2019-02-26)
|
306 |
|
307 |
|
308 |
|
309 | <a name="9.2.0"></a>
|
310 | # [9.2.0](https://github.com/documentationjs/documentation/compare/v9.1.1...v9.2.0) (2019-02-22)
|
311 |
|
312 |
|
313 | ### Bug Fixes
|
314 |
|
315 | * **default theme:** only render either note or section (fixes [#1113](https://github.com/documentationjs/documentation/issues/1113)) ([#1206](https://github.com/documentationjs/documentation/issues/1206)) ([fb0a27f](https://github.com/documentationjs/documentation/commit/fb0a27f))
|
316 |
|
317 |
|
318 | ### Features
|
319 |
|
320 | * Add favicon option ([#1207](https://github.com/documentationjs/documentation/issues/1207)) ([5b045f2](https://github.com/documentationjs/documentation/commit/5b045f2))
|
321 |
|
322 |
|
323 |
|
324 | <a name="9.1.1"></a>
|
325 | ## [9.1.1](https://github.com/documentationjs/documentation/compare/v9.1.0...v9.1.1) (2018-12-21)
|
326 |
|
327 |
|
328 | ### Bug Fixes
|
329 |
|
330 | * inferred properties duplicating explicitly specified ones ([2d0bd0e](https://github.com/documentationjs/documentation/commit/2d0bd0e))
|
331 |
|
332 |
|
333 |
|
334 | <a name="9.1.0"></a>
|
335 | # [9.1.0](https://github.com/documentationjs/documentation/compare/v9.0.0...v9.1.0) (2018-12-17)
|
336 |
|
337 |
|
338 | ### Features
|
339 |
|
340 | * support spead types ([ca5a681](https://github.com/documentationjs/documentation/commit/ca5a681))
|
341 |
|
342 |
|
343 |
|
344 | <a name="9.0.0"></a>
|
345 | # [9.0.0](https://github.com/documentationjs/documentation/compare/v9.0.0-alpha.1...v9.0.0) (2018-12-10)
|
346 |
|
347 |
|
348 | ### Features
|
349 |
|
350 | * Support for the logical assignment operator ([58d2a2f](https://github.com/documentationjs/documentation/commit/58d2a2f)), closes [#1172](https://github.com/documentationjs/documentation/issues/1172)
|
351 |
|
352 |
|
353 |
|
354 | <a name="9.0.0-alpha.1"></a>
|
355 | # [9.0.0-alpha.1](https://github.com/documentationjs/documentation/compare/v9.0.0-alpha.0...v9.0.0-alpha.1) (2018-10-24)
|
356 |
|
357 |
|
358 | ### Bug Fixes
|
359 |
|
360 | * **package:** update [@babel](https://github.com/babel)/parser to version 7.1.3 ([4dbb406](https://github.com/documentationjs/documentation/commit/4dbb406)), closes [#1145](https://github.com/documentationjs/documentation/issues/1145)
|
361 | * add node-resolve to module-deps ([a033547](https://github.com/documentationjs/documentation/commit/a033547))
|
362 | * add tests ([a4107dc](https://github.com/documentationjs/documentation/commit/a4107dc))
|
363 |
|
364 |
|
365 | ### Features
|
366 |
|
367 | * add support for node resolve algo ([ddd675d](https://github.com/documentationjs/documentation/commit/ddd675d))
|
368 |
|
369 |
|
370 |
|
371 | <a name="9.0.0-alpha.0"></a>
|
372 | # [9.0.0-alpha.0](https://github.com/documentationjs/documentation/compare/v8.1.2...v9.0.0-alpha.0) (2018-09-21)
|
373 |
|
374 |
|
375 | ### Features
|
376 |
|
377 | * Babel 7 support ([49c0f72](https://github.com/documentationjs/documentation/commit/49c0f72))
|
378 |
|
379 |
|
380 | ### BREAKING CHANGES
|
381 |
|
382 | * This moves documentation.js to Babel 7. From now on,
|
383 | documentation.js will only support Babel 7: please stick to older
|
384 | releases if you need to support Babel 6. Additionally, this work
|
385 | temporarily disables support for following dynamic imports.
|
386 |
|
387 |
|
388 |
|
389 | <a name="8.1.2"></a>
|
390 | ## [8.1.2](https://github.com/documentationjs/documentation/compare/v8.1.1...v8.1.2) (2018-08-23)
|
391 |
|
392 |
|
393 | ### Bug Fixes
|
394 |
|
395 | * membership infering for methods ([#1122](https://github.com/documentationjs/documentation/issues/1122)) ([40b1783](https://github.com/documentationjs/documentation/commit/40b1783))
|
396 |
|
397 |
|
398 |
|
399 | <a name="8.1.1"></a>
|
400 | ## [8.1.1](https://github.com/documentationjs/documentation/compare/v8.1.0...v8.1.1) (2018-08-17)
|
401 |
|
402 |
|
403 | ### Bug Fixes
|
404 |
|
405 | * Serve on correct port ([4d59f6f](https://github.com/documentationjs/documentation/commit/4d59f6f))
|
406 |
|
407 |
|
408 |
|
409 | <a name="8.1.0"></a>
|
410 | # [8.1.0](https://github.com/documentationjs/documentation/compare/v8.0.2...v8.1.0) (2018-08-03)
|
411 |
|
412 |
|
413 | ### Bug Fixes
|
414 |
|
415 | * **package:** update get-port to version 4.0.0 ([9ca8c06](https://github.com/documentationjs/documentation/commit/9ca8c06))
|
416 |
|
417 |
|
418 | ### Features
|
419 |
|
420 | * added project description ([45a9ea9](https://github.com/documentationjs/documentation/commit/45a9ea9))
|
421 |
|
422 |
|
423 |
|
424 | <a name="8.0.2"></a>
|
425 | ## [8.0.2](https://github.com/documentationjs/documentation/compare/v8.0.1...v8.0.2) (2018-07-20)
|
426 |
|
427 |
|
428 | ### Bug Fixes
|
429 |
|
430 | * **package:** update git-url-parse to version 10.0.1 ([91ade89](https://github.com/documentationjs/documentation/commit/91ade89))
|
431 |
|
432 |
|
433 |
|
434 | <a name="8.0.1"></a>
|
435 | ## [8.0.1](https://github.com/documentationjs/documentation/compare/v8.0.0...v8.0.1) (2018-07-16)
|
436 |
|
437 |
|
438 | ### Bug Fixes
|
439 |
|
440 | * **package:** update read-pkg-up to version 4.0.0 ([c700d3f](https://github.com/documentationjs/documentation/commit/c700d3f))
|
441 |
|
442 |
|
443 |
|
444 | <a name="8.0.0"></a>
|
445 | # [8.0.0](https://github.com/documentationjs/documentation/compare/v7.1.0...v8.0.0) (2018-06-04)
|
446 |
|
447 |
|
448 | ### Features
|
449 |
|
450 | * Semantic markdown headings ([#1087](https://github.com/documentationjs/documentation/issues/1087)) ([ca6217f](https://github.com/documentationjs/documentation/commit/ca6217f))
|
451 |
|
452 |
|
453 | ### BREAKING CHANGES
|
454 |
|
455 | * changes Markdown output
|
456 |
|
457 |
|
458 |
|
459 | <a name="7.1.0"></a>
|
460 | # [7.1.0](https://github.com/documentationjs/documentation/compare/v7.0.0...v7.1.0) (2018-05-26)
|
461 |
|
462 |
|
463 | ### Features
|
464 |
|
465 | * support flow comment types ([85d50f9](https://github.com/documentationjs/documentation/commit/85d50f9))
|
466 |
|
467 |
|
468 |
|
469 | <a name="7.0.0"></a>
|
470 | # [7.0.0](https://github.com/documentationjs/documentation/compare/v6.3.3...v7.0.0) (2018-05-22)
|
471 |
|
472 |
|
473 | ### Features
|
474 |
|
475 | * Auto-detect readme filename ([4fd776b](https://github.com/documentationjs/documentation/commit/4fd776b))
|
476 |
|
477 |
|
478 | ### BREAKING CHANGES
|
479 |
|
480 | * the --readme-file option now has a smart default value
|
481 |
|
482 |
|
483 |
|
484 | <a name="6.3.3"></a>
|
485 | ## [6.3.3](https://github.com/documentationjs/documentation/compare/v6.3.2...v6.3.3) (2018-05-14)
|
486 |
|
487 |
|
488 |
|
489 | <a name="6.3.2"></a>
|
490 | ## [6.3.2](https://github.com/documentationjs/documentation/compare/v6.3.1...v6.3.2) (2018-04-24)
|
491 |
|
492 |
|
493 | ### Bug Fixes
|
494 |
|
495 | * **vue:** Make vue parser tolerant of components that don't contain scripts ([#1061](https://github.com/documentationjs/documentation/issues/1061)) ([8f9bc7b](https://github.com/documentationjs/documentation/commit/8f9bc7b)), closes [#1060](https://github.com/documentationjs/documentation/issues/1060)
|
496 |
|
497 |
|
498 |
|
499 | <a name="6.3.1"></a>
|
500 | ## [6.3.1](https://github.com/documentationjs/documentation/compare/v6.3.0...v6.3.1) (2018-04-23)
|
501 |
|
502 |
|
503 | ### Bug Fixes
|
504 |
|
505 | * adding vue support broke tests that are not file based ([#1058](https://github.com/documentationjs/documentation/issues/1058)) ([9d7bd2e](https://github.com/documentationjs/documentation/commit/9d7bd2e)), closes [#1057](https://github.com/documentationjs/documentation/issues/1057)
|
506 |
|
507 |
|
508 |
|
509 | <a name="6.3.0"></a>
|
510 | # [6.3.0](https://github.com/documentationjs/documentation/compare/v6.2.0...v6.3.0) (2018-04-20)
|
511 |
|
512 |
|
513 | ### Bug Fixes
|
514 |
|
515 | * **package:** update git-url-parse to version 9.0.0 ([94a1fb6](https://github.com/documentationjs/documentation/commit/94a1fb6))
|
516 |
|
517 |
|
518 | ### Features
|
519 |
|
520 | * Vue Support ([f60d90c](https://github.com/documentationjs/documentation/commit/f60d90c))
|
521 |
|
522 |
|
523 |
|
524 | <a name="6.2.0"></a>
|
525 | # [6.2.0](https://github.com/documentationjs/documentation/compare/v6.1.0...v6.2.0) (2018-04-11)
|
526 |
|
527 |
|
528 | ### Bug Fixes
|
529 |
|
530 | * get rid of shelljs dependency ([630625d](https://github.com/documentationjs/documentation/commit/630625d))
|
531 |
|
532 |
|
533 | ### Features
|
534 |
|
535 | * **doctrine:** Support decorator syntax in examples ([b309d39](https://github.com/documentationjs/documentation/commit/b309d39)), closes [#1016](https://github.com/documentationjs/documentation/issues/1016)
|
536 | * **inferTypes:** Support class properties ([22d8740](https://github.com/documentationjs/documentation/commit/22d8740)), closes [#1043](https://github.com/documentationjs/documentation/issues/1043)
|
537 |
|
538 |
|
539 |
|
540 | <a name="6.1.0"></a>
|
541 | # [6.1.0](https://github.com/documentationjs/documentation/compare/v6.0.0...v6.1.0) (2018-03-08)
|
542 |
|
543 |
|
544 | ### Bug Fixes
|
545 |
|
546 | * lends with object property using literal key ([#1035](https://github.com/documentationjs/documentation/issues/1035)) ([99ad49b](https://github.com/documentationjs/documentation/commit/99ad49b))
|
547 |
|
548 |
|
549 | ### Features
|
550 |
|
551 | * Support class property [@type](https://github.com/type) tag ([#1028](https://github.com/documentationjs/documentation/issues/1028)) ([4ed5edf](https://github.com/documentationjs/documentation/commit/4ed5edf))
|
552 |
|
553 |
|
554 |
|
555 | <a name="6.0.0"></a>
|
556 | # [6.0.0](https://github.com/documentationjs/documentation/compare/v5.5.0...v6.0.0) (2018-03-02)
|
557 |
|
558 |
|
559 | ### Features
|
560 |
|
561 | * documentation.js now requires node v6 or newer. ([#1034](https://github.com/documentationjs/documentation/issues/1034)) ([ccce516](https://github.com/documentationjs/documentation/commit/ccce516))
|
562 |
|
563 |
|
564 | ### BREAKING CHANGES
|
565 |
|
566 | * documentation.js requires node v6 or newer.
|
567 |
|
568 |
|
569 |
|
570 | <a name="5.5.0"></a>
|
571 | # [5.5.0](https://github.com/documentationjs/documentation/compare/v5.4.0...v5.5.0) (2018-03-02)
|
572 |
|
573 |
|
574 | ### Bug Fixes
|
575 |
|
576 | * github links for [@typedef](https://github.com/typedef) comments should link to comment, not context ([#1024](https://github.com/documentationjs/documentation/issues/1024)) ([37a91b2](https://github.com/documentationjs/documentation/commit/37a91b2))
|
577 | * Make documentation.js compatible with node 4.x for one more version ([#1033](https://github.com/documentationjs/documentation/issues/1033)) ([5067ee0](https://github.com/documentationjs/documentation/commit/5067ee0))
|
578 |
|
579 |
|
580 | ### Features
|
581 |
|
582 | * Support `--shallow` argument for `lint` command. Closes [#956](https://github.com/documentationjs/documentation/issues/956) ([#995](https://github.com/documentationjs/documentation/issues/995)) ([64f660d](https://github.com/documentationjs/documentation/commit/64f660d))
|
583 | * Support the .mjs extension by default. ([#1023](https://github.com/documentationjs/documentation/issues/1023)) ([b8a7e0d](https://github.com/documentationjs/documentation/commit/b8a7e0d))
|
584 | * use reference links for Markdown output, improving brevity ([ab494dd](https://github.com/documentationjs/documentation/commit/ab494dd))
|
585 |
|
586 |
|
587 |
|
588 | <a name="5.4.0"></a>
|
589 | # [5.4.0](https://github.com/documentationjs/documentation/compare/v5.3.5...v5.4.0) (2018-02-10)
|
590 |
|
591 |
|
592 | ### Bug Fixes
|
593 |
|
594 | * **package:** update remark-toc to version 5.0.0 ([0bb3d0d](https://github.com/documentationjs/documentation/commit/0bb3d0d))
|
595 |
|
596 |
|
597 | ### Features
|
598 |
|
599 | * add support for class param declarations at the constructor ([#1013](https://github.com/documentationjs/documentation/issues/1013)) ([05c5279](https://github.com/documentationjs/documentation/commit/05c5279))
|
600 |
|
601 |
|
602 |
|
603 | <a name="5.3.5"></a>
|
604 | ## [5.3.5](https://github.com/documentationjs/documentation/compare/v5.3.4...v5.3.5) (2017-12-12)
|
605 |
|
606 |
|
607 | ### Bug Fixes
|
608 |
|
609 | * **globals-docs:** Remove en-US from MDN links. ([#973](https://github.com/documentationjs/documentation/issues/973)) ([aa661ff](https://github.com/documentationjs/documentation/commit/aa661ff)), closes [#964](https://github.com/documentationjs/documentation/issues/964)
|
610 |
|
611 |
|
612 |
|
613 | <a name="5.3.4"></a>
|
614 | ## [5.3.4](https://github.com/documentationjs/documentation/compare/v5.3.3...v5.3.4) (2017-12-12)
|
615 |
|
616 |
|
617 | ### Bug Fixes
|
618 |
|
619 | * **package:** update babelify to version 8.0.0 ([10dff6f](https://github.com/documentationjs/documentation/commit/10dff6f))
|
620 | * **package:** update read-pkg-up to version 3.0.0 ([d8fbf2c](https://github.com/documentationjs/documentation/commit/d8fbf2c))
|
621 | * **package:** update remark-html to version 7.0.0 ([9842814](https://github.com/documentationjs/documentation/commit/9842814))
|
622 | * **package:** update vinyl-fs to version 3.0.0 ([#966](https://github.com/documentationjs/documentation/issues/966)) ([1d6fe80](https://github.com/documentationjs/documentation/commit/1d6fe80))
|
623 |
|
624 |
|
625 |
|
626 | <a name="5.3.3"></a>
|
627 | ## [5.3.3](https://github.com/documentationjs/documentation/compare/v5.3.2...v5.3.3) (2017-10-12)
|
628 |
|
629 |
|
630 | ### Bug Fixes
|
631 |
|
632 | * **html:** Display all levels of parameter properties. ([#933](https://github.com/documentationjs/documentation/issues/933)) ([7a548eb](https://github.com/documentationjs/documentation/commit/7a548eb))
|
633 | * **package:** update github-slugger to version 1.2.0 ([2b74956](https://github.com/documentationjs/documentation/commit/2b74956))
|
634 | * Fix the split in HTML at 33/67% instead of calculating percentages ([#939](https://github.com/documentationjs/documentation/issues/939)) ([e4781eb](https://github.com/documentationjs/documentation/commit/e4781eb)), closes [#927](https://github.com/documentationjs/documentation/issues/927)
|
635 |
|
636 |
|
637 |
|
638 | <a name="5.3.2"></a>
|
639 | ## [5.3.2](https://github.com/documentationjs/documentation/compare/v5.3.1...v5.3.2) (2017-09-15)
|
640 |
|
641 |
|
642 | ### Bug Fixes
|
643 |
|
644 | * special property names in flowtypes ([7fc6ca8](https://github.com/documentationjs/documentation/commit/7fc6ca8))
|
645 |
|
646 |
|
647 |
|
648 | <a name="5.3.1"></a>
|
649 | ## [5.3.1](https://github.com/documentationjs/documentation/compare/v5.3.0...v5.3.1) (2017-09-07)
|
650 |
|
651 |
|
652 | ### Bug Fixes
|
653 |
|
654 | * cover more hideconstructor cases ([5bdbf1f](https://github.com/documentationjs/documentation/commit/5bdbf1f))
|
655 | * Enable dynamicImport plugin to support import() syntax ([#903](https://github.com/documentationjs/documentation/issues/903)) ([b97241f](https://github.com/documentationjs/documentation/commit/b97241f)), closes [#902](https://github.com/documentationjs/documentation/issues/902)
|
656 | * regression in toc causing crash ([125a577](https://github.com/documentationjs/documentation/commit/125a577))
|
657 |
|
658 |
|
659 |
|
660 | <a name="5.3.0"></a>
|
661 | # [5.3.0](https://github.com/documentationjs/documentation/compare/v5.2.2...v5.3.0) (2017-09-04)
|
662 |
|
663 |
|
664 | ### Bug Fixes
|
665 |
|
666 | * [@name](https://github.com/name) tag disconnects comment ([#897](https://github.com/documentationjs/documentation/issues/897)) ([a04b6fd](https://github.com/documentationjs/documentation/commit/a04b6fd))
|
667 |
|
668 |
|
669 | ### Features
|
670 |
|
671 | * groups in toc ([#895](https://github.com/documentationjs/documentation/issues/895)) ([c94412a](https://github.com/documentationjs/documentation/commit/c94412a))
|
672 | * implement [@hideconstructor](https://github.com/hideconstructor) ([#898](https://github.com/documentationjs/documentation/issues/898)) ([7a07d51](https://github.com/documentationjs/documentation/commit/7a07d51))
|
673 |
|
674 |
|
675 |
|
676 | <a name="5.2.2"></a>
|
677 | ## [5.2.2](https://github.com/documentationjs/documentation/compare/v5.2.1...v5.2.2) (2017-08-22)
|
678 |
|
679 |
|
680 | ### Bug Fixes
|
681 |
|
682 | * **$compile:** prevent babel from transpiling non-module scripts in default_theme's assets ([1286a1f](https://github.com/documentationjs/documentation/commit/1286a1f))
|
683 |
|
684 |
|
685 |
|
686 | <a name="5.2.1"></a>
|
687 | ## [5.2.1](https://github.com/documentationjs/documentation/compare/v5.2.0...v5.2.1) (2017-08-12)
|
688 |
|
689 |
|
690 |
|
691 | <a name="5.2.0"></a>
|
692 | # [5.2.0](https://github.com/documentationjs/documentation/compare/v5.1.1...v5.2.0) (2017-08-09)
|
693 |
|
694 |
|
695 | ### Bug Fixes
|
696 |
|
697 | * alphabetical sort and add flow notation to sort file ([#861](https://github.com/documentationjs/documentation/issues/861)) ([aa3496a](https://github.com/documentationjs/documentation/commit/aa3496a)), closes [#838](https://github.com/documentationjs/documentation/issues/838)
|
698 | * make html and markdown second option optional ([#871](https://github.com/documentationjs/documentation/issues/871)) ([0324865](https://github.com/documentationjs/documentation/commit/0324865)), closes [#869](https://github.com/documentationjs/documentation/issues/869)
|
699 |
|
700 |
|
701 | ### Features
|
702 |
|
703 | * convert Flow's ThisTypeAnnotation to a doctrine NameExpression ([#870](https://github.com/documentationjs/documentation/issues/870)) ([23aa981](https://github.com/documentationjs/documentation/commit/23aa981))
|
704 |
|
705 |
|
706 |
|
707 | <a name="5.1.1"></a>
|
708 | ## [5.1.1](https://github.com/documentationjs/documentation/compare/v5.1.0...v5.1.1) (2017-08-04)
|
709 |
|
710 |
|
711 | ### Bug Fixes
|
712 |
|
713 | * **theme:** Remove dead stepsibling navigation code ([dccb151](https://github.com/documentationjs/documentation/commit/dccb151))
|
714 | * cli options should override package.json options ([ecf16bd](https://github.com/documentationjs/documentation/commit/ecf16bd)), closes [#845](https://github.com/documentationjs/documentation/issues/845)
|
715 |
|
716 |
|
717 |
|
718 | <a name="5.1.0"></a>
|
719 | # [5.1.0](https://github.com/documentationjs/documentation/compare/v5.0.1...v5.1.0) (2017-07-31)
|
720 |
|
721 |
|
722 | ### Bug Fixes
|
723 |
|
724 | * **scripts:** Remove changelog package.json task ([dddac19](https://github.com/documentationjs/documentation/commit/dddac19))
|
725 |
|
726 |
|
727 | ### Features
|
728 |
|
729 | * **theme:** Flexible sidebar for default theme ([6509ae8](https://github.com/documentationjs/documentation/commit/6509ae8))
|
730 |
|
731 |
|
732 |
|
733 | <a name="5.0.1"></a>
|
734 | ## [5.0.1](https://github.com/documentationjs/documentation/compare/v5.0.0...v5.0.1) (2017-07-28)
|
735 |
|
736 |
|
737 |
|
738 | <a name="5.0.0"></a>
|
739 | # [5.0.0](https://github.com/documentationjs/documentation/compare/v4.0.0...v5.0.0) (2017-07-27)
|
740 |
|
741 |
|
742 | ### Reverts
|
743 |
|
744 | * **polyglot:** Remove polyglot mode ([5b373ff](https://github.com/documentationjs/documentation/commit/5b373ff)), closes [#850](https://github.com/documentationjs/documentation/issues/850) [#731](https://github.com/documentationjs/documentation/issues/731) [#702](https://github.com/documentationjs/documentation/issues/702) [#132](https://github.com/documentationjs/documentation/issues/132)
|
745 |
|
746 |
|
747 | ### BREAKING CHANGES
|
748 |
|
749 | * **polyglot:** I'd like to still support C++ and other languages in the future! But I'm much
|
750 | happier doing so by separating the extraction & input phases to the degree that documentation.js can
|
751 | read the output of another module that extracts JSDoc comments from C++ code, rather than having CPP
|
752 | support in it.
|
753 |
|
754 |
|
755 |
|
756 | <a name="4.0.0"></a>
|
757 | # [4.0.0](https://github.com/documentationjs/documentation/compare/v4.0.0-rc.1...v4.0.0) (2017-07-27)
|
758 |
|
759 |
|
760 | ### Bug Fixes
|
761 |
|
762 | * **html output:** Fix links between navigation and items in HTML documentation ([5fb77bc](https://github.com/documentationjs/documentation/commit/5fb77bc))
|
763 | * **package:** update babel-generator to version 6.25.0 ([#804](https://github.com/documentationjs/documentation/issues/804)) ([65f5a37](https://github.com/documentationjs/documentation/commit/65f5a37))
|
764 | * **package:** update chalk to version 2.0.0 ([#833](https://github.com/documentationjs/documentation/issues/833)) ([2329db4](https://github.com/documentationjs/documentation/commit/2329db4))
|
765 | * **package:** update github-slugger to version 1.1.3 ([#793](https://github.com/documentationjs/documentation/issues/793)) ([74392cc](https://github.com/documentationjs/documentation/commit/74392cc))
|
766 | * Show () for callbacks ([61968c7](https://github.com/documentationjs/documentation/commit/61968c7))
|
767 | * **package:** update micromatch to version 3.0.0 ([#792](https://github.com/documentationjs/documentation/issues/792)) ([3f2bf90](https://github.com/documentationjs/documentation/commit/3f2bf90))
|
768 | * **package:** update remark to version 8.0.0 ([1ae8136](https://github.com/documentationjs/documentation/commit/1ae8136))
|
769 | * Fix filtering in the default theme ([473f317](https://github.com/documentationjs/documentation/commit/473f317))
|
770 | * Report nesting errors instead of throwing them as errors ([ea69608](https://github.com/documentationjs/documentation/commit/ea69608)), closes [#832](https://github.com/documentationjs/documentation/issues/832)
|
771 | * **package:** update remark-html to version 6.0.1 ([#815](https://github.com/documentationjs/documentation/issues/815)) ([e472550](https://github.com/documentationjs/documentation/commit/e472550))
|
772 | * **package:** update vfile-reporter to version 4.0.0 ([a3e1fb8](https://github.com/documentationjs/documentation/commit/a3e1fb8))
|
773 |
|
774 |
|
775 |
|
776 | <a name="4.0.0-rc.1"></a>
|
777 | # [4.0.0-rc.1](https://github.com/documentationjs/documentation/compare/v4.0.0-rc.0...v4.0.0-rc.1) (2017-05-01)
|
778 |
|
779 |
|
780 | ### Bug Fixes
|
781 |
|
782 | * Infer parameters for classes from constructors ([355038d](https://github.com/documentationjs/documentation/commit/355038d)), closes [#689](https://github.com/documentationjs/documentation/issues/689)
|
783 | * **document-exported:** Ensure that document-exported does not document constructors separately ([96a6d13](https://github.com/documentationjs/documentation/commit/96a6d13))
|
784 | * **flow:** Fix inference of Flow types with properties ([#751](https://github.com/documentationjs/documentation/issues/751)) ([7c00acc](https://github.com/documentationjs/documentation/commit/7c00acc)), closes [#749](https://github.com/documentationjs/documentation/issues/749)
|
785 | * **params:** Parameters with default use = not ? ([3cc4426](https://github.com/documentationjs/documentation/commit/3cc4426)), closes [#737](https://github.com/documentationjs/documentation/issues/737)
|
786 |
|
787 |
|
788 | ### Features
|
789 |
|
790 | * **lint:** Identify explicit tags that don't match inference in lint stage ([ed5c2a0](https://github.com/documentationjs/documentation/commit/ed5c2a0))
|
791 |
|
792 |
|
793 |
|
794 | <a name="4.0.0-rc.0"></a>
|
795 | # [4.0.0-rc.0](https://github.com/documentationjs/documentation/compare/v4.0.0-beta.19...v4.0.0-rc.0) (2017-04-21)
|
796 |
|
797 |
|
798 | ### Bug Fixes
|
799 |
|
800 | * **html output:** Fix github links in HTML output ([#745](https://github.com/documentationjs/documentation/issues/745)) ([9554b2f](https://github.com/documentationjs/documentation/commit/9554b2f)), closes [#738](https://github.com/documentationjs/documentation/issues/738)
|
801 | * **params:** added code path for type RestElement ([6961ee8](https://github.com/documentationjs/documentation/commit/6961ee8))
|
802 |
|
803 |
|
804 | ### Code Refactoring
|
805 |
|
806 | * **nest:** Better nesting implementation ([#732](https://github.com/documentationjs/documentation/issues/732)) ([7374730](https://github.com/documentationjs/documentation/commit/7374730))
|
807 |
|
808 |
|
809 | ### BREAKING CHANGES
|
810 |
|
811 | * **nest:** referencing inferred destructure params without
|
812 | renaming them, like $0.x, from JSDoc comments will no longer
|
813 | work. To reference them, instead add a param tag to name the
|
814 | destructuring param, and then refer to members of that name.
|
815 |
|
816 | Before:
|
817 |
|
818 | ```js
|
819 | /**
|
820 | * @param {number} $0.x a member of x
|
821 | */
|
822 | function a({ x }) {}
|
823 | ```
|
824 |
|
825 | After:
|
826 |
|
827 | ```js
|
828 | /**
|
829 | * @param {Object} options
|
830 | * @param {number} options.x a member of x
|
831 | */
|
832 | function a({ x }) {}
|
833 | ```
|
834 |
|
835 | * Address review comments
|
836 |
|
837 | * Reduce testing node requirement back down to 4
|
838 |
|
839 | * Don't output empty properties, reduce diff noise
|
840 |
|
841 | * Rearrange and document params
|
842 |
|
843 | * Simplify param inference, update test fixtures. This is focused around Array destructuring: documenting destructured array elements with indices instead of names, because the names are purely internal details
|
844 |
|
845 | * Use temporary fork to get through blocker
|
846 |
|
847 |
|
848 |
|
849 | <a name="4.0.0-beta.19"></a>
|
850 | # [4.0.0-beta.19](https://github.com/documentationjs/documentation/compare/v4.0.0-beta.18...v4.0.0-beta.19) (2017-04-10)
|
851 |
|
852 |
|
853 | ### Bug Fixes
|
854 |
|
855 | * **inference:** Refactor membership inference ([84c9215](https://github.com/documentationjs/documentation/commit/84c9215))
|
856 | * **inference:** Robust parsing for shorthand object methods ([802dc4c](https://github.com/documentationjs/documentation/commit/802dc4c))
|
857 | * **scopes:** Support inner scope ([#665](https://github.com/documentationjs/documentation/issues/665)) ([8cc34b6](https://github.com/documentationjs/documentation/commit/8cc34b6))
|
858 |
|
859 |
|
860 | ### Features
|
861 |
|
862 | * **core:** Support Flow interface declarations ([e2915dc](https://github.com/documentationjs/documentation/commit/e2915dc))
|
863 | * **core:** Switch to Promises everywhere. Adopt Node v4 ES6 ([#648](https://github.com/documentationjs/documentation/issues/648)) ([631c692](https://github.com/documentationjs/documentation/commit/631c692))
|
864 | * **markdown:** Add `[@see](https://github.com/see)` tag output in Markdown ([#682](https://github.com/documentationjs/documentation/issues/682)) ([f07285a](https://github.com/documentationjs/documentation/commit/f07285a))
|
865 |
|
866 |
|
867 |
|
868 | <a name="4.0.0-beta.18"></a>
|
869 | # [4.0.0-beta.18](https://github.com/documentationjs/documentation/compare/v4.0.0-beta.17...v4.0.0-beta.18) (2016-12-29)
|
870 |
|
871 |
|
872 | ### Bug Fixes
|
873 |
|
874 | * **cli:** Fix error reporting in the CLI ([88c8f9a](https://github.com/documentationjs/documentation/commit/88c8f9a))
|
875 | * **markdown:** Start headings in Markdown at h2 (#644) ([2ae5d8f](https://github.com/documentationjs/documentation/commit/2ae5d8f))
|
876 |
|
877 | ### Features
|
878 |
|
879 | * **bin:** Support globs on windows and use smarter recursion (#629) ([cb8fdfa](https://github.com/documentationjs/documentation/commit/cb8fdfa)), closes [#607](https://github.com/documentationjs/documentation/issues/607)
|
880 | * **markdown:** Add table of contents support for Markdown mode (#645) ([4c66fb1](https://github.com/documentationjs/documentation/commit/4c66fb1))
|
881 |
|
882 | ### Performance Improvements
|
883 |
|
884 | * **dependencies:** Move standard-changelog to devDependencies (#636) ([7a66b3f](https://github.com/documentationjs/documentation/commit/7a66b3f))
|
885 |
|
886 |
|
887 |
|
888 | <a name="4.0.0-beta.17"></a>
|
889 | # [4.0.0-beta.17](https://github.com/documentationjs/documentation/compare/v4.0.0-beta16...v4.0.0-beta.17) (2016-12-23)
|
890 |
|
891 | This release also fixes a mistake I was making with semver: pre-v4 beta
|
892 | releases will be called `beta.17` and `beta.18` and so on, rather than
|
893 | non-standard `beta16` without the `.`.
|
894 |
|
895 |
|
896 | ### Bug Fixes
|
897 |
|
898 | * **hierarchy:** collect events from static and instance members (#628) ([f1e0267](https://github.com/documentationjs/documentation/commit/f1e0267)), closes [#486](https://github.com/documentationjs/documentation/issues/486)
|
899 |
|
900 |
|
901 |
|
902 | <a name="4.0.0-beta16"></a>
|
903 | # [4.0.0-beta16](https://github.com/documentationjs/documentation/compare/v4.0.0-beta15...v4.0.0-beta16) (2016-12-07)
|
904 |
|
905 |
|
906 | ### Bug Fixes
|
907 |
|
908 | * **bin:** Remove dead code in documentation.js command (#627) ([ab16a20](https://github.com/documentationjs/documentation/commit/ab16a20))
|
909 | * **extractors:** Document export default value (#623) ([363a108](https://github.com/documentationjs/documentation/commit/363a108)), closes [#543](https://github.com/documentationjs/documentation/issues/543)
|
910 | * **parser:** Avoid error about deoptimization on very large files (#621) ([846ab94](https://github.com/documentationjs/documentation/commit/846ab94))
|
911 |
|
912 | ### Features
|
913 |
|
914 | * **build:** load passed in config option (#625) ([89fb67f](https://github.com/documentationjs/documentation/commit/89fb67f))
|
915 | * **output:** Display type information for typedefs in Markdown and HTML ([8b04029](https://github.com/documentationjs/documentation/commit/8b04029))
|
916 |
|
917 |
|
918 |
|
919 |
|
920 | <a name="4.0.0-beta15"></a>
|
921 | # [4.0.0-beta15](https://github.com/documentationjs/documentation/compare/v4.0.0-beta14...v4.0.0-beta15) (2016-11-23)
|
922 |
|
923 | ### Fixes
|
924 |
|
925 | * Infer class augments tag in cases like `Foo extends React.Component`
|
926 |
|
927 | ### Features
|
928 |
|
929 | * **config:** add file property for notes ([#614](https://github.com/documentationjs/documentation/issues/614)) ([d96aa47](https://github.com/documentationjs/documentation/commit/d96aa47)), closes [#609](https://github.com/documentationjs/documentation/issues/609)
|
930 |
|
931 |
|
932 |
|
933 | ## 4.0.0-beta14
|
934 |
|
935 | * Highlight all Markdown, not just examples. Fixes #610
|
936 | * Fix for `--config` only strip comments on json files (#611)
|
937 | * Merge inferred return type like we do for params. Refs #359 (#604)
|
938 | * Support webpack's System.import with nice handy babel plugin (#603)
|
939 | * Format optional types with ? instead of [] (#538)
|
940 | * Fix membership assignment for old-fashioned prototype members (#599)
|
941 | * Update Node API documentation to include only exposed API surface
|
942 | * Add too-much-inference troubleshooting topic
|
943 |
|
944 | ## 4.0.0-beta13
|
945 |
|
946 | * Fix linker null reference error
|
947 |
|
948 | ## 4.0.0-beta12
|
949 |
|
950 | * Update Doctrine to handle more JSDoc types
|
951 | * Fix ReferenceError in default theme
|
952 | * Show GitHub link for nested elements in default theme
|
953 | * Fix linking resolution order
|
954 |
|
955 | ## 4.0.0-beta11
|
956 |
|
957 | * Improved support for Flow: function types, object types, mixed types, null,
|
958 | void, typedefs
|
959 | * New option: [sort-order](https://github.com/documentationjs/documentation/pull/535)
|
960 | * Updates to Babylon 6.10.x
|
961 | * Updates to dependencies, including yargs.
|
962 | * [`document-exported` now traverses only exported code](https://github.com/documentationjs/documentation/pull/533).
|
963 |
|
964 | ## 4.0.0-beta10
|
965 |
|
966 | * Lower memory consumption when dealing with large codebases
|
967 | * Better support for detecting names and kinds of ES6-exported values
|
968 | * New `document-exported` flag allows you to automatically document
|
969 | ES6-exported values, without even a comment! [490](https://github.com/documentationjs/documentation/pull/490)
|
970 |
|
971 | ## 4.0.0-beta5
|
972 |
|
973 | * Add decorator support (zacharygolba)
|
974 | * Add support to infer whether functions are private based on their name,
|
975 | like starting with `_` (arv)
|
976 | * Improve internal documentation
|
977 |
|
978 | ## 4.0.0-beta4
|
979 |
|
980 | * Fix minor dependency mistake
|
981 |
|
982 | ## 4.0.0-beta3
|
983 |
|
984 | * Updates theme to a much-improved design
|
985 | * Fix augments tag display in HTML
|
986 | * Improve name detection of ES6-exported methods and variables
|
987 | * Allow documentation of Object.prototype methods
|
988 |
|
989 | ## 4.0.0-beta2
|
990 |
|
991 | Minor fixes
|
992 |
|
993 | * Fixes `export { foo } from './bar'` style export
|
994 | * Fixed CLI usage examples to simply say `documentation` instead of `/usr/bin/documentation` or
|
995 | similar.
|
996 |
|
997 | ## 4.0.0-beta1
|
998 |
|
999 | **Now using Babel 6!**
|
1000 |
|
1001 | Much long-awaited upgrade makes documentation.js compatible with fresh
|
1002 | new Babel-using codebases.
|
1003 |
|
1004 | And also:
|
1005 |
|
1006 | * GitHub Enterprise support
|
1007 | * New tag support: abstract, override, readonly, interface, variation, see, todo
|
1008 | (only in parsing phase, not yet in all outputs)
|
1009 | * Parses jsx and es6 extensions by default, as well as .js
|
1010 | * Fixes polyglot mode
|
1011 | * Now shows the `@throws` tag content in Markdown output
|
1012 | * Support for example captions
|
1013 |
|
1014 | ## 4.0.0-beta
|
1015 |
|
1016 | **Revitalized documentation.js command line interface!**
|
1017 |
|
1018 | The `documentation` utility now takes commands:
|
1019 |
|
1020 | * `documentation build` extracts and formats documentation
|
1021 | * `documentation serve` provides an auto-reloading server ([#236](https://github.com/documentationjs/documentation/pull/236))
|
1022 | * `documentation lint` reviews files for inconsistencies
|
1023 | * `documentation readme` patches API documentation into a readme ([#313](https://github.com/documentationjs/documentation/pull/313) by @anandthakker)
|
1024 |
|
1025 | This functionality was previously included in `dev-documentation` and has
|
1026 | been folded into `documentation` proper.
|
1027 |
|
1028 | **Much more flexible themes**
|
1029 |
|
1030 | Themes are now much more customizable. In documentation.js 3.x and before, themes
|
1031 | were required to use Handlebars templates and produce a single page. In
|
1032 | documentation.js 4.x and beyond, they are JavaScript modules that can use
|
1033 | any template engine and produce any number of files. See the
|
1034 | [new theme documentation](https://github.com/documentationjs/documentation/blob/master/docs/THEMING.md) for
|
1035 | details.
|
1036 |
|
1037 | **More precise traversal**
|
1038 |
|
1039 | Inference in 4.x is stricter than in 3.x: comments must be adjacent
|
1040 | to the statements they document. This should make documentation generation
|
1041 | much more predictable.
|
1042 |
|
1043 | **Support for the revealing module pattern**
|
1044 |
|
1045 | ```js
|
1046 | /** Foo */
|
1047 | function Foo() {
|
1048 | /** Test */
|
1049 | function bar() {}
|
1050 | return {
|
1051 | bar: bar
|
1052 | };
|
1053 | }
|
1054 | ````
|
1055 |
|
1056 | New support for the [JavaScript module pattern](http://www.macwright.org/2012/06/04/the-module-pattern.html)!
|
1057 | This was implemented in [#324](https://github.com/documentationjs/documentation/pull/324)
|
1058 | by [Charlie Brown](https://github.com/carbonrobot).
|
1059 |
|
1060 | **Breaking changes**
|
1061 |
|
1062 | * documentation.js now follows the [JSDoc standard's interpretation of the @name tag](http://usejsdoc.org/tags-name.html):
|
1063 | specifying a name tag will turn off inference. If you still want inference
|
1064 | but want to call code something else, use the [@alias tag](http://usejsdoc.org/tags-alias.html) instead.
|
1065 |
|
1066 | ## 3.0.4
|
1067 |
|
1068 | * Allow parameter types to be mixed into explicit parameter documentation. (#239 and #232)
|
1069 | * Support GitHub links in Markdown output (#238)
|
1070 |
|
1071 | ## 3.0.3
|
1072 |
|
1073 | * Infer typedefs from Flow type aliases. Fixes #227
|
1074 | * Fix type-annotated rest expressions, raised in #230
|
1075 |
|
1076 | ## 3.0.2
|
1077 |
|
1078 | * Infer rest parameters. Fixes #223
|
1079 | * Avoid filtering comments in lint mode. Fixes #186
|
1080 | * Nest both properties and params. Fixes #164
|
1081 |
|
1082 | ## 3.0.1
|
1083 |
|
1084 | * BUGFIX: Fix default theme resolution [#212](https://github.com/documentationjs/documentation/pull/212)
|
1085 |
|
1086 | ## 3.0.0
|
1087 |
|
1088 | The largest change to documentation.js so far.
|
1089 |
|
1090 | **Dropping streams**
|
1091 |
|
1092 | This a major refactor of the documentation.js interface with a focus on
|
1093 | simplifying the system. Up until this point, documentation.js was built around
|
1094 | [node.js streams](https://nodejs.org/api/stream.html), which are low-level
|
1095 | representations of asynchronous series of data. While this abstraction was
|
1096 | appropriate for the input and github streams, which are asynchronous, the
|
1097 | majority of documentation.js's internals are simple and synchronous functions
|
1098 | for which basic functional composition makes more sense than stream
|
1099 | semantics.
|
1100 |
|
1101 | Documentation 3.0.0 uses simple functional composition for operations like
|
1102 | parmameter inference, rather than streams.
|
1103 |
|
1104 | **Stronger support for ES6, ES7, and Flow**
|
1105 |
|
1106 | We've switched to [Babel](https://babeljs.io/) as our source code parser,
|
1107 | which means that we have much broader support of new JavaScript features,
|
1108 | including import/export syntax and new features in ES6.
|
1109 |
|
1110 | Babel also parses [Flow type annotations](http://flowtype.org/docs/type-annotations.html),
|
1111 | and new inference code means that we can infer
|
1112 |
|
1113 | * Parameter names & types
|
1114 | * Return types
|
1115 |
|
1116 | Without any explicit JSDoc tags. This means that for many simple functions,
|
1117 | we can generate great documentation with less writing.
|
1118 |
|
1119 | **Stronger module support**
|
1120 |
|
1121 | Documentation.js now has much better inference for membership and names of symbols
|
1122 | exported via `exports` or `module.exports`.
|
1123 |
|
1124 | **Support for nested symbols**
|
1125 |
|
1126 | The parent/child relationship between symbols is now fully hierarchical, and
|
1127 | symbols can be nested to any depth. For instance:
|
1128 |
|
1129 | ```
|
1130 | /**
|
1131 | * A global Parent class.
|
1132 | */
|
1133 | var Parent = function () {};
|
1134 |
|
1135 | /**
|
1136 | * A Child class.
|
1137 | */
|
1138 | Parent.Child = function () {};
|
1139 |
|
1140 | /**
|
1141 | * A Grandchild class.
|
1142 | */
|
1143 | Parent.Child.Grandchild = function () {};
|
1144 | ```
|
1145 |
|
1146 | In addition, filtering by access is now applied to the entire hierarchy: if you
|
1147 | mark a class as `@private`, neither it nor its children will be included in the
|
1148 | output by default, regardless of the access specifiers of the children.
|
1149 |
|
1150 | **mdast-based Markdown output**
|
1151 |
|
1152 | We've switched from templating Markdown output with [Handlebars.js](http://handlebarsjs.com/)
|
1153 | to generating an [abstract syntax tree](https://en.wikipedia.org/wiki/Abstract_syntax_tree)
|
1154 | of desired output and stringifying it with [mdast](https://github.com/wooorm/mdast).
|
1155 | This lets documentation.js output complex Markdown without having to worry
|
1156 | about escaping and properly formatting certain elements.
|
1157 |
|
1158 | **Test coverage 100%**
|
1159 |
|
1160 | documentation.js returns to 100% test coverage, so every single line
|
1161 | of code is covered by our large library of text fixtures and specific tests.
|
1162 |
|
1163 | **--lint mode**
|
1164 |
|
1165 | Specifying the `--lint` flag makes documentation.js check for non-standard
|
1166 | types, like `String`, or missing namespaces. If the encountered files have
|
1167 | any problems, it pretty-prints helpful debug messages and exits with status 1,
|
1168 | and otherwise exits with no output and status 0.
|
1169 |
|
1170 | **Breaking changes**
|
1171 |
|
1172 | * The `--version` flag is now `--project-version`. `--version` now outputs
|
1173 | documentation.js's version
|
1174 |
|
1175 | ## 2.0.1
|
1176 |
|
1177 | * Fixes `@param` tags that refer to properties of unmentioned objects: these
|
1178 | will warn instead of crashing. For instance, `/** @param {boolean} foo.bar */`.
|
1179 | * Expose `--shallow` option in CLI
|
1180 |
|
1181 | ## 2.0.0
|
1182 |
|
1183 | * Breaking: Removes `docset` support from documentation.js: this will be supported
|
1184 | by a 3rd party tool in the future. This removal means that we no longer have
|
1185 | node-sqlite3 as a dependency, and documentation can be installed on systems
|
1186 | without a compile toolchain.
|
1187 | * JSDoc parse errors are now printed to stderr.
|
1188 | * Parameter tags that document sub-parameters, such as `@param {Type} options.option`,
|
1189 | are now nested under their parent parameter.
|
1190 | * HTML output now includes events.
|
1191 | * Error messages now include source file name and line number.
|
1192 | * @typedef names are now inferred correctly.
|
1193 |
|
1194 | ## 1.4.0
|
1195 |
|
1196 | * Output for the `@throws` tag.
|
1197 | * Output in HTML for the `@properties` tag.
|
1198 |
|
1199 | ## 1.3.0
|
1200 |
|
1201 | * Now infers `name` from `class` and `event` tags
|
1202 | * Support for documenting C++ code with the `polyglot` option and `--polyglot` CLI option
|
1203 | * Fixed github linking
|
1204 | * Support for [JSDoc3-style bracketed optional parameters](http://usejsdoc.org/tags-param.html#optional-parameters-and-default-values), like
|
1205 |
|
1206 | ```js
|
1207 | /**
|
1208 | * @param {Type} [param=defaultValue]
|
1209 | */
|
1210 | ```
|
1211 |
|
1212 | ## 1.2.0
|
1213 |
|
1214 | * Transforms in package.json `browserify.transform` fields are now applied to
|
1215 | source code so that babel, etc can be supported.
|
1216 | * Fixes crash caused by requiring JSON files
|
1217 |
|
1218 | ## 1.1.0
|
1219 |
|
1220 | * Add `external` option that allows the user to whitelist specific external
|
1221 | modules to be included in with documentation.
|
1222 |
|
1223 | ## 1.0.7
|
1224 |
|
1225 | * Fixes sorting order of documentation
|
1226 | * Switches order of static and instance members in output
|