Generates documentation for your REST API from annotations
MIT License
Bot releases are visible (Hide)
See https://github.com/nelmio/NelmioApiDocBundle/blob/master/UPGRADE-3.0.md to migrate from an application using 2.x.
Published by lsmith77 over 7 years ago
Published by willdurand over 8 years ago
Hi!
Here is a new version of this bundle with a few improvements and bug fixes. As I asked on Twitter, I am thinking about slowly deprecating this bundle. That would mean:
When I started this project, we needed a simple yet efficient and fast way to document our APIs at Nelmio. Nowadays, this project has become the bundle for documenting APIs in the Symfony world, with more than 3.3 million installs (June 2016). Four years ago, the Swagger project was something we considered a bit but it was not even version 1.0, and we did not choose it for some reasons I cannot even remember. Anyway, now there is Swagger version 2, which is really powerful and nice (and almost a standard).
This bundle does not support Swagger v2 unfortunately, and users started to hack around this bundle and Swagger: https://blog.liip.ch/archive/2016/05/11/convert-nelmioapidocbundle-to-swagger-php.html. I believe it is a wise decision.
I already did a "call for maintainers" a while ago, but it is rather complicated to get someone involved in a project for a reasonable period of time (which I perfectly understand), and I have not been contacted by anyone. On the other hand, I don't personally use this bundle, hence I cannot maintain it anymore.
That is why I am thinking about deprecating this bundle, and encouraging more recent and robust alternatives. Feel free to get in touch with me (or by email using the address on my profile).
Thanks,
William.
ApiDocExtractor
overridingcurl
command to sandboxOUTPUT_RAW
to avoid JS syntax error when dumping HTML API doc (cf. #864)Published by willdurand over 8 years ago
The bundle declares a conflict with symfony/symfony
~2.7.8 (that means, Symfony 2.7.8, 2.7.9, etc. until 2.8.0).
xhrFields: { withCredentials: true }
to ajaxOptions
to enable browser authentication for cross origin API requests* Fixed: PUT vs PATCH paramters (cf. #565)DunglasApiParser
(cf. #678)hasOption()
Published by willdurand almost 9 years ago
enterScope()
in DumpCommand
Published by willdurand almost 9 years ago
Published by willdurand almost 9 years ago
Hi! This release contains a few bug fixes, but the main improvement is the support of Symfony 3.0.
Special thank to @Ener-Getick! And tank you to all other contributors.
JsonSerializableParser
mergeParameters()
that covers this issuePublished by willdurand almost 9 years ago
@ApiDoc
parameters setting will override lower parameter definitions in the hierarchy (#739)Published by willdurand almost 9 years ago
The whole documentation has been updated!
Published by willdurand almost 9 years ago