{"action":"created","issue":{"url":"https://api.github.com/repos/nelmio/NelmioApiDocBundle/issues/900","repository_url":"https://api.github.com/repos/nelmio/NelmioApiDocBundle","labels_url":"https://api.github.com/repos/nelmio/NelmioApiDocBundle/issues/900/labels{/name}","comments_url":"https://api.github.com/repos/nelmio/NelmioApiDocBundle/issues/900/comments","events_url":"https://api.github.com/repos/nelmio/NelmioApiDocBundle/issues/900/events","html_url":"https://github.com/nelmio/NelmioApiDocBundle/issues/900","id":172521141,"number":900,"title":"[RFC] Future of NelmioApiDocBundle (v3 ?)","user":{"login":"joelwurtz","id":90466,"avatar_url":"https://avatars.githubusercontent.com/u/90466?v=3","gravatar_id":"","url":"https://api.github.com/users/joelwurtz","html_url":"https://github.com/joelwurtz","followers_url":"https://api.github.com/users/joelwurtz/followers","following_url":"https://api.github.com/users/joelwurtz/following{/other_user}","gists_url":"https://api.github.com/users/joelwurtz/gists{/gist_id}","starred_url":"https://api.github.com/users/joelwurtz/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/joelwurtz/subscriptions","organizations_url":"https://api.github.com/users/joelwurtz/orgs","repos_url":"https://api.github.com/users/joelwurtz/repos","events_url":"https://api.github.com/users/joelwurtz/events{/privacy}","received_events_url":"https://api.github.com/users/joelwurtz/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":12,"created_at":"2016-08-22T18:27:04Z","updated_at":"2016-08-23T09:55:25Z","closed_at":null,"body":"Hello,\r\n\r\nI recently contacted @willdurand for a plan about the future of this Bundle, as some of you have may have [read / heard](https://github.com/nelmio/NelmioApiDocBundle/releases/tag/2.13.0) that he does not wish to maintain this libray anymore. \r\n\r\nIn this text, he speaks about Swagger v2, which, i totally agree, is now close to be a defacto standard for REST API specification and documentation.\r\n\r\nHowever NelmioApiDocBundle give a very easy path for developers to expose their API documentation by just writing the server part, which brings many benefits: less maintenance, pure synchronisation between doc and code and support a large variety of API \"builders\" (jms, dunglas api bundle, fos rest).\r\n\r\nGiven those facts, the goal would be to keep the current easy and synchronized way of doing, but refactoring the \"view\" part to only expose an [OpenAPI specification (new name of Swagger)](https://openapis.org/).\r\n\r\nAll this work will be release in a v3, we will also use this version to reduce the scope of dependencies: There will be support for Symfony >= 2.8 and PHP >= 5.5.9 (same version supported by Symfony 3.X).\r\n\r\nThere will still be work on the 2.X branch of NelmioApiDocBundle, however it will be restricted to bugs fixes at the condition it doesn't involve too many changes (it would certainly not be done if it implies to refactor too many things in order to be fix, unless there is a good PR).\r\n\r\nBefore going into this direction we would like to hear from you (people using this bundle) if you think or don't think it's a good way to improve this library."},"comment":{"url":"https://api.github.com/repos/nelmio/NelmioApiDocBundle/issues/comments/241683391","html_url":"https://github.com/nelmio/NelmioApiDocBundle/issues/900#issuecomment-241683391","issue_url":"https://api.github.com/repos/nelmio/NelmioApiDocBundle/issues/900","id":241683391,"user":{"login":"Ener-Getick","id":6871899,"avatar_url":"https://avatars.githubusercontent.com/u/6871899?v=3","gravatar_id":"","url":"https://api.github.com/users/Ener-Getick","html_url":"https://github.com/Ener-Getick","followers_url":"https://api.github.com/users/Ener-Getick/followers","following_url":"https://api.github.com/users/Ener-Getick/following{/other_user}","gists_url":"https://api.github.com/users/Ener-Getick/gists{/gist_id}","starred_url":"https://api.github.com/users/Ener-Getick/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Ener-Getick/subscriptions","organizations_url":"https://api.github.com/users/Ener-Getick/orgs","repos_url":"https://api.github.com/users/Ener-Getick/repos","events_url":"https://api.github.com/users/Ener-Getick/events{/privacy}","received_events_url":"https://api.github.com/users/Ener-Getick/received_events","type":"User","site_admin":false},"created_at":"2016-08-23T09:55:25Z","updated_at":"2016-08-23T09:55:25Z","body":"@hpatoio that's more or less what i tried to do in https://github.com/EXSyst/ApiDocBundle.\r\nFor example, it can read the docs generated by swagger-php but also complete it (read params from the path, read other annotations, etc)."}}
{"actor":{"display_login":"Ener-Getick"}}