mirror of
https://github.com/jsdoc/jsdoc.git
synced 2025-12-08 19:46:11 +00:00
+ Use `cosmiconfig` instead of rolling our own code (which gives us YAML support)
+ Look for the config in these locations, and in this order:
+ A `jsdoc` property in `package.json`
+ `.jsdocrc` (can be JSON or YAML; comments not allowed for JSON)
+ `.jsdocrc.json` (comments allowed)
+ `.jsdocrc.yaml`
+ `.jsdocrc.yml`
+ `.jsdocrc.js`
+ `jsdoc.config.js`
Testing JSDoc
JSDoc uses Jasmine as its testing framework. See the Jasmine documentation for details.
Running tests
Clone the GitHub repository; change to its directory; and run the following commands:
npm install
node jsdoc.js -T
Writing tests
You can write tests for all of the following:
- JSDoc itself. See the
testdirectory. Test specs are intest/specs, and fixtures used by the tests are intest/fixtures. - Plugins. See the
plugins/testdirectory. - Packages. See the
packages/**/testdirectories.