Author Content in Jsdoc or Xml format Source Comments

Document! X will use any JsDoc or XML format source comments that exist in the Javascript you are documenting, so you can leverage any existing documentation effort. Adding type information in your source comments will improve the level of documentation Document! X is able to produce for your members.

/**
* constructs a new myType object
* @constructor
* @param {string} p1 p1 summary
* @param {number} p2 p2 summary
*/
function myType(p1, p2) {

}

/** field summary */
myType.prototype.field = 0;

/**
* method summary
* @param {string} p1 p1 summary
* @returns {number} method returns
*/
myType.prototype.method = function(p1) {

}

function myType(p1, p2) {
    ///<summary>constructs a new myType object</summary>
    ///<param name="p1" type="string">p1 summary</param>
    ///<param name="p2" type="number">p2 summary</param>
}
 
///<summary>field summary</summary>
myType.prototype.field = 0;
 
///<summary>method summary</summary>
///<param name="p1" type="string">p1 summary</param>
///<returns type="number">method returns</returns>
myType.prototype.method = function(p1) {
}

Customization

The template based configuration that Document! X is based on makes it easy to:

• Create new comment types for use in source code comments;
• Adapt existing templates to match your existing corporate style and color scheme;
• Customize Table of Contents definitions according to your requirements;
• Fine tune the standard phrases and terminology used by Document! X to match your standards.

Authoring examples

The easy to use Example code designer included in the Content Editors makes adding multi-language examples a breeze. In-line or linked examples can be created and example code is automatically colorized in the generated output.

Localization

Document! X supports several different languages (English, French, German, Dutch, Italian and Russian)  for the phrases used in the generated output. All of the phrases and terminology in the generated output can be configured according to preference.

Document! X allows you to author content for multiple languages within a single project, showing you an embedded tip for the primary locale content when you are authoring in the Content File Editor for a secondary locale. If you use the Document! X and HelpStudio bundle you can export and import your localized content in XLIFF format; the industry standard for sending and receiving translation content from translation providers.