* Add shared_options to readme command.
This makes --shallow and --format work again.
* Update yarn.lock based on package.json.
* Move readme example to where it works,
remove superfluous usage string.
yargs@>=7 throws exceptions on incorrectly structured builder objects.
* Update expected readme test fixture.
* Update bin-readme snapshot.
* s/_.assign/Object.assign/g thanks to node@>=4.
* Update yarn.lock based on package.json (lint-staged@6)
* Override flow error message.
* build: Use Flow syntax without comments.
We're switching to Flow annotations - not Flow comments. This
gives documentation.js the ability to self-document without
JSDoc types and improves our compatibility with tools like
prettier.
Fixes#729. Fixes#709
* feat(core): Switch to Promises everywhere. Adopt Node v4 ES6
Big changes:
* Uses template strings where appropriate
* Config and argument parsing is unified and there is no such thing
as formatterOptions anymore. All user-passed options go through
mergeConfig.
* The node API surface changed (again): `buildSync` is removed,
building operations return Promises.
* Now using Flow for internal type annotations.
More changes:
* Remove buildSync command
* feat(inference): Partially implement object shorthand support
* Refs #649
* Use Flow annotations to enforce types
* Keep flow but switch to comment syntax
* Clarify types
* More flow improvements
* Turn server into class
* LinkerStack becomes class too
* Fix comment description type
* Run flow on lint
* Many more flow fixes
* More intense flow refactoring
* Simplify inference steps
* Update inference tests, flow errors down to 1
* Continue refining types
* Fix more flow issues
* Use 'use strict' everywhere
* Make 'ast' property configurable
* Fix many tests
* Fix more tests
* Fix more tests
* Fix augments
* Test Markdown meta support
* Improve test coverage
* Switch back from for of to for for speed
Arg parsing is now split into common options (in bin/documentation.js)
and command-specific options (in each command module, exported as
parseArgs).
This includes moving `--private` and `--github` to the common args
instead of having them under the build/serve commands. Reason: these
two args are options understood by the main module, as opposed to args
like `--format` which are only understood by the actual output piece
in build/serve.
Also removes `args.js`, which had previously exported the argument
parsing for use in situations like documentation-readme. The need
for this, I think, is largely made irrelevant in the face of slightly
generalizing the CLI to use commands.
