2016-12-29 13:35:36 +01:00
|
|
|
NelmioApiDocBundle
|
|
|
|
==================
|
2016-11-18 18:00:09 +01:00
|
|
|
|
2016-12-29 13:35:36 +01:00
|
|
|
[![Build
|
2018-01-04 14:33:02 +01:00
|
|
|
Status](https://travis-ci.org/nelmio/NelmioApiDocBundle.svg?branch=master)](http://travis-ci.org/nelmio/NelmioApiDocBundle)
|
2016-12-29 13:35:36 +01:00
|
|
|
[![Total Downloads](https://poser.pugx.org/nelmio/api-doc-bundle/downloads)](https://packagist.org/packages/nelmio/api-doc-bundle)
|
|
|
|
[![Latest Stable
|
|
|
|
Version](https://poser.pugx.org/nelmio/api-doc-bundle/v/stable)](https://packagist.org/packages/nelmio/api-doc-bundle)
|
|
|
|
|
|
|
|
The **NelmioApiDocBundle** bundle allows you to generate a decent documentation
|
|
|
|
for your APIs.
|
2016-11-18 18:00:09 +01:00
|
|
|
|
2017-05-13 17:55:09 +02:00
|
|
|
## Migrate from 2.x to 3.0
|
|
|
|
|
2020-07-24 16:58:58 +02:00
|
|
|
[To migrate from 2.x to 3.0, follow our guide.](https://github.com/nelmio/NelmioApiDocBundle/blob/3.x/UPGRADE-3.0.md)
|
2017-05-13 17:55:09 +02:00
|
|
|
|
2016-11-18 18:00:09 +01:00
|
|
|
## Installation
|
|
|
|
|
2018-01-04 17:47:47 +01:00
|
|
|
Open a command console, enter your project directory and execute the following command to download the latest version of this bundle:
|
2017-05-13 16:39:37 +02:00
|
|
|
|
2016-11-18 18:00:09 +01:00
|
|
|
```
|
2018-01-04 14:33:02 +01:00
|
|
|
composer require nelmio/api-doc-bundle
|
2016-11-18 18:00:09 +01:00
|
|
|
```
|
|
|
|
|
2018-01-04 14:33:02 +01:00
|
|
|
## Documentation
|
2016-11-18 18:00:09 +01:00
|
|
|
|
2020-07-24 16:58:58 +02:00
|
|
|
[Read the documentation on symfony.com](https://symfony.com/doc/3.x/bundles/NelmioApiDocBundle/index.html)
|
2016-12-29 13:35:36 +01:00
|
|
|
|
|
|
|
## Contributing
|
|
|
|
|
|
|
|
See
|
2020-07-24 16:58:58 +02:00
|
|
|
[CONTRIBUTING](https://github.com/nelmio/NelmioApiDocBundle/blob/3.x/CONTRIBUTING.md)
|
2016-12-29 13:35:36 +01:00
|
|
|
file.
|
|
|
|
|
|
|
|
## Running the Tests
|
|
|
|
|
|
|
|
Install the [Composer](http://getcomposer.org/) dependencies:
|
|
|
|
|
|
|
|
git clone https://github.com/nelmio/NelmioApiDocBundle.git
|
|
|
|
cd NelmioApiDocBundle
|
2020-07-24 16:58:58 +02:00
|
|
|
git checkout 3.x
|
2016-12-29 13:35:36 +01:00
|
|
|
composer update
|
|
|
|
|
2017-05-13 16:39:37 +02:00
|
|
|
Then run the test suite:
|
2016-12-29 13:35:36 +01:00
|
|
|
|
2017-05-13 16:39:37 +02:00
|
|
|
./phpunit
|
2016-12-29 13:35:36 +01:00
|
|
|
|
|
|
|
## License
|
|
|
|
|
|
|
|
This bundle is released under the MIT license.
|