apiDoc
Generates a RESTful web API Documentation.
Changes from previous version visit CHANGELOG.md
apiDoc creates a documentation from API descriptions in your source code.
Documentation at apidocjs.com.
Example output.
Installation
npm install apidoc-bitfinder -g
Changelog
Example
/** * @api * @apiName GetUser * @apiGroup User * * @apiParam * * @apiSuccess * @apiSuccess */
apidoc -i example/ -o doc/
Creates from input files in example/
a documentation in path doc/
.
More examples and best practice hints: EXAMPLES.md
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.#*=podThis is a comment.=cut -
Python
"""This is a comment.""" -
Ruby
=beginThis is a comment.=end
Build tools
- flask-apidoc
pip install flask-apidoc
- grunt-apidoc
npm install grunt-apidoc
. - gapidoc (gulp)
npm install gapidoc
. - gulp-apidoc
npm install gulp-apidoc
. - gulp-apidocjs
npm install gulp-apidocjs
.
Editor integration
Converter
FAQ
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.