Skip to content

cjbarth/apidoc

 
 

Repository files navigation

apiDoc 0.7.x

Generates a RESTful web API Documentation.

Build Status NPM version

Documentation at apidocjs.com.

Example output.

Installation

npm install apidoc -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. */

apidoc -i example/ -o doc/

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

Supported programming languages

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

    /**  * 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

Grunt Module

grunt-apidoc npm install grunt-apidoc.

Changelog

CHANGELOG.md

Help

Please add issues if you have a question or found a problem. Pull requests are welcome too!

A chat about apiDoc is on Gitter.

Gitter chat

License

Copyright (c) 2013-2014 inveris OHG

Author Peter Rottmann rottmann@inveris.de

Licensed under the MIT license.

About

RESTful web API Documentation Generator

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 92.8%
  • CSS 7.2%