-
Notifications
You must be signed in to change notification settings - Fork 182
Brackets JSDocs Guidelines
Brackets uses Google Closure Compiler Annotation format for API Documentation.
The API Docs for the current master branch can be found at http://brackets.io/docs/current.
Header comments can not have an empty line between end of comment and module definition:
/**
* Header comment
*/
define(function (require, exports, module) {
Explicitly add an empty line for comments that should not appear in API Doc:
/*jslint vars: true, plusplus: true, devel: true, nomen: true, indent: 4 */
/*global define, $, brackets, window */
define(function (require, exports, module) {
Markdown formatting is supported, so it will be reflected in the API Docs.
Only code with JSDoc annotations will show up in the API Docs, with the following exceptions:
- Dependencies
The apify nodejs app is used to generate the Brackets API Docs.
If you have the apify app installed, then you can use the Brackets Apify extension to generate API Documentation on-the-fly for your local branch.
The Grunt Apify app is for automating the generation of API Docs.