zanApi

Generates a RESTful web API Documentation.

Installation

npm install zanapi -g

Example

/**
 * @api {get} /user/:id Request User information
 * @apiName GetUser
 * @apiGroup User
 *
 * @apiParam {Number} id Users unique ID.
 *
 * @apiSuccess {String} firstname Firstname of the User.
 * @apiSuccess {String} lastname  Lastname of the User.
 */

zanapi -i example/ -o doc/

Creates from input files in example/ a documentation in path doc/.

Supported programming languages

• C#, Go, Dart, Java, JavaScript, PHP, Scala (all DocStyle capable languages):

  /**
    * This is a comment.
    */

• Clojure:

  ;;;;
  ;; This is a comment.
  ;;;;

• CoffeeScript:

  ###
  This is a comment.
  ###

• Erlang:

  %{
  This is a comment.
  %}

• Perl

  #**
  # This is a comment.
  #*

  =pod
  This is a comment.
  =cut

• Python

  """
  This is a comment.
  """

• Ruby

  =begin
  This is a comment.
  =end