Changelog History
Page 9
-
v4.0.0-beta15 Changes
November 23, 2016 -
v4.0.0-beta14 Changes
- ๐ Highlight all Markdown, not just examples. Fixes #610
- ๐ Fix for
--config
only strip comments on json files (#611) - ๐ Merge inferred return type like we do for params. Refs #359 (#604)
- ๐ Support webpack's System.import with nice handy babel plugin (#603)
- Format optional types with ? instead of
- ๐ Fix membership assignment for old-fashioned prototype members (#599)
- ๐ Update Node API documentation to include only exposed API surface
- โ Add too-much-inference troubleshooting topic
-
v4.0.0-beta13 Changes
- ๐ Fix linker null reference error
-
v4.0.0-beta12 Changes
- โก๏ธ Update Doctrine to handle more JSDoc types
- ๐ Fix ReferenceError in default theme
- 0๏ธโฃ Show GitHub link for nested elements in default theme
- ๐ Fix linking resolution order
-
v4.0.0-beta11 Changes
- ๐ Improved support for Flow: function types, object types, mixed types, null, void, typedefs
- ๐ New option: sort-order
- โก๏ธ Updates to Babylon 6.10.x
- โก๏ธ Updates to dependencies, including yargs.
- ๐
document-exported
now traverses only exported code.
-
v4.0.0-beta10 Changes
- Lower memory consumption when dealing with large codebases
- ๐ Better support for detecting names and kinds of ES6-exported values
- ๐ New
document-exported
flag allows you to automatically document ES6-exported values, without even a comment! 490
-
v4.0.0-beta1 Changes
Now using Babel 6!
๐ Much long-awaited upgrade makes documentation.js compatible with fresh ๐ new Babel-using codebases.
And also:
- ๐ GitHub Enterprise support
- ๐ New tag support: abstract, override, readonly, interface, variation, see, todo (only in parsing phase, not yet in all outputs)
- 0๏ธโฃ Parses jsx and es6 extensions by default, as well as .js
- ๐ Fixes polyglot mode
- Now shows the
@throws
tag content in Markdown output - ๐ Support for example captions
-
v4.0.0-beta Changes
๐ Revitalized documentation.js command line interface!
๐ The
documentation
utility now takes commands:- ๐
documentation build
extracts and formats documentation - ๐
documentation serve
provides an auto-reloading server (#236) - ๐
documentation lint
reviews files for inconsistencies - ๐
documentation readme
patches API documentation into a readme (#313 by @anandthakker)
๐ This functionality was previously included in
dev-documentation
and has ๐ been folded intodocumentation
proper.Much more flexible themes
๐ Themes are now much more customizable. In documentation.js 3.x and before, themes were required to use Handlebars templates and produce a single page. In ๐ documentation.js 4.x and beyond, they are JavaScript modules that can use ๐ any template engine and produce any number of files. See the ๐ new theme documentation for details.
More precise traversal
Inference in 4.x is stricter than in 3.x: comments must be adjacent ๐ to the statements they document. This should make documentation generation much more predictable.
๐ Support for the revealing module pattern
/** Foo */ function Foo() { /** Test */ function bar() {} return { bar: bar }; }
๐ New support for the JavaScript module pattern! ๐ This was implemented in #324 by Charlie Brown.
๐ฅ Breaking changes
- ๐ documentation.js now follows the JSDoc standard's interpretation of the @name tag: specifying a name tag will turn off inference. If you still want inference but want to call code something else, use the @alias tag instead.
- ๐
-
v3.0.4 Changes
- ๐ Allow parameter types to be mixed into explicit parameter documentation. (#239 and #232)
- ๐ Support GitHub links in Markdown output (#238)
-
v3.0.3 Changes
- ๐ Infer typedefs from Flow type aliases. Fixes #227
- ๐ Fix type-annotated rest expressions, raised in #230