-
Notifications
You must be signed in to change notification settings - Fork 151
Exemplary APIs
Aral Balkan edited this page Mar 23, 2020
·
9 revisions
Links to generated examples.
These examples all generate custom README files, passing a handlebars template to --template
.
Project | Notes |
---|---|
handbrake-js |
A module exposing two methods and an inner class. Demonstrates documenting events, linked types and use of |
command-line-args | Demonstrates documentation of a @module exporting a ES2015 class, the @typicalname , @throws and @alias tags. |
array-tools | Very simple module exporting a collection of static methods. Demonstrates use of @example and @category to group identifiers in the member-list. |
jesucarr/tokenbucket | Demonstrates --param-list-format list and the documentation of Promises using the @fulfil and @reject tags. |
ansi-escape-sequences | Demonstrates usage of @enum {type} (rendered in table format). |
Feel free to send me a link to your docs.
- EmergingTechnologyAdvisors/node-serialport
- apache/cordova-plugin-camera (customised)
- Polymer/polymer-analyzer
- Google/eddystone
- websockets/ws
- wikimedia/node-rdkafka
- noodlefrenzy/node-amqp10 (massive, tables, ascii diagrams)
- IBM-Bluemix/gp-js-client
- alexmingoia/koa-router
- IjzerenHein/famous-map
- devicehive/devicehive-javascript
- dc-js/dc.js (massive)
-
alexindigo/multibundle-mapper (use of
--private
) -
AndyOGo/gulp-pilot (uses
@example
captions and custom tags)
- Home
- How jsdoc2md works
- Additional jsdoc tags supported
- Cherry picking which documentation appears in output
- Showcase ...
- Create ...
- How To ...
- How to use with npm run
- How to use with gulp
- How to create one output file per class
- How to document a AMD module
- How to document a CommonJS module (exports)
- How to document a CommonJS module (module.exports)
- How to document an ES2015 module (multiple named exports)
- How to document an ES2015 module (single default export)
- How to document Promises (using custom tags)
- How to document a ToDo list
- How to document ES2017 features
- How to document TypeScript
- The @typicalname tag
- Linking to external resources
- Param list format options
- Listing namepaths
- Troubleshooting