NelmioApiDocBundle/README.md

51 lines
1.4 KiB
Markdown
Raw Normal View History

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.