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.

Guidelines

Header Comments

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

Markdown formatting is supported, so it will be reflected in the API Docs.

Exceptions

Only code with JSDoc annotations will show up in the API Docs, with the following exceptions:

• Dependencies

Generating Documents

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.