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.
|
2012-04-12 19:42:53 +02:00
|
|
|
|
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
|
|
|
|
2012-04-12 19:42:53 +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)
|
2013-04-12 17:05:13 +02:00
|
|
|
|
|
|
|
|
2013-11-14 11:39:29 +01:00
|
|
|
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.
|
2013-11-14 11:39:29 +01:00
|
|
|
|
|
|
|
|
|
|
|
License
|
|
|
|
-------
|
|
|
|
|
|
|
|
This bundle is released under the MIT license. See the complete license in the
|
|
|
|
bundle:
|
|
|
|
|
|
|
|
Resources/meta/LICENSE
|