NelmioApiDocBundle/README.md

63 lines
1.3 KiB
Markdown
Raw Normal View History

2012-04-12 18:38:13 +02:00
NelmioApiDocBundle
==================
2013-11-14 11:43:09 +01:00
[![Build
Status](https://secure.travis-ci.org/nelmio/NelmioApiDocBundle.png?branch=master)](http://travis-ci.org/nelmio/NelmioApiDocBundle)
2012-04-14 02:44:05 +03:00
2013-11-14 11:43:09 +01:00
The **NelmioApiDocBundle** bundle allows you to generate a decent documentation
for your APIs.
2013-11-14 11:43:09 +01:00
**Important:** This bundle is developed in sync with [symfony's
repository](https://github.com/symfony/symfony).
For Symfony `2.0.x`, you need to use the `1.*` version of the bundle.
2012-05-23 09:44:19 +02:00
2013-11-14 11:43:09 +01:00
Documentation
-------------
2012-04-12 18:38:13 +02:00
2013-11-14 11:43:09 +01:00
For documentation, see:
2012-07-13 16:06:01 +02:00
2013-11-14 11:43:09 +01:00
Resources/doc/
2012-04-12 19:10:02 +02:00
2013-11-14 11:43:09 +01:00
[Read the
ocumentation](https://github.com/nelmio/NelmioApiDocBundle/blob/master/Resources/doc/index.md)
Contributing
------------
See
[CONTRIBUTING](https://github.com/nelmio/NelmioApiDocBundle/blob/master/CONTRIBUTING.md)
file.
Running the Tests
-----------------
Install the [Composer](http://getcomposer.org/) `dev` dependencies:
php composer.phar install --dev
Then, run the test suite using
[PHPUnit](https://github.com/sebastianbergmann/phpunit/):
phpunit
Credits
-------
2012-04-12 19:10:02 +02:00
2013-11-14 11:43:09 +01:00
The design is heavily inspired by the
[swagger-ui](https://github.com/wordnik/swagger-ui) project.
Some icons from the [Glyphicons](http://glyphicons.com/) library are used to
render the documentation.
License
-------
This bundle is released under the MIT license. See the complete license in the
bundle:
Resources/meta/LICENSE