{"action":"created","issue":{"url":"https://api.github.com/repos/eclipse/microprofile-open-api/issues/251","repository_url":"https://api.github.com/repos/eclipse/microprofile-open-api","labels_url":"https://api.github.com/repos/eclipse/microprofile-open-api/issues/251/labels{/name}","comments_url":"https://api.github.com/repos/eclipse/microprofile-open-api/issues/251/comments","events_url":"https://api.github.com/repos/eclipse/microprofile-open-api/issues/251/events","html_url":"https://github.com/eclipse/microprofile-open-api/issues/251","id":346828183,"node_id":"MDU6SXNzdWUzNDY4MjgxODM=","number":251,"title":"Breaking changes for 2.0","user":{"login":"arthurdm","id":5042215,"node_id":"MDQ6VXNlcjUwNDIyMTU=","avatar_url":"https://avatars0.githubusercontent.com/u/5042215?v=4","gravatar_id":"","url":"https://api.github.com/users/arthurdm","html_url":"https://github.com/arthurdm","followers_url":"https://api.github.com/users/arthurdm/followers","following_url":"https://api.github.com/users/arthurdm/following{/other_user}","gists_url":"https://api.github.com/users/arthurdm/gists{/gist_id}","starred_url":"https://api.github.com/users/arthurdm/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/arthurdm/subscriptions","organizations_url":"https://api.github.com/users/arthurdm/orgs","repos_url":"https://api.github.com/users/arthurdm/repos","events_url":"https://api.github.com/users/arthurdm/events{/privacy}","received_events_url":"https://api.github.com/users/arthurdm/received_events","type":"User","site_admin":false},"labels":[{"id":1012031364,"node_id":"MDU6TGFiZWwxMDEyMDMxMzY0","url":"https://api.github.com/repos/eclipse/microprofile-open-api/labels/2.0%20candidate","name":"2.0 candidate","color":"006b75","default":false}],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":15,"created_at":"2018-08-02T01:42:48Z","updated_at":"2018-11-27T18:02:41Z","closed_at":null,"author_association":"MEMBER","body":"This issue will encapsulate breaking changes that we're considering for a future `2.0` release.  Things like removing deprecated functionality,  removing incorrect classes / methods, changing parts of the design, etc.   \r\n\r\nThese items can go into the [2.0 branch](https://github.com/eclipse/microprofile-open-api/tree/2.0).\r\n\r\nTo add an item to this list please add a comment.  \r\n\r\nCurrent list of `2.0` proposals:\r\n\r\n- [ ] update extensible and non-extensible\r\n    Links: [models](https://github.com/eclipse/microprofile-open-api/issues/251#issuecomment-409778777) \r\n- [ ] Remove methods that were renamed (and deprecated) in 1.1 \r\n    Links: [256](https://github.com/eclipse/microprofile-open-api/pull/256)  [261](https://github.com/eclipse/microprofile-open-api/pull/261) [268](https://github.com/eclipse/microprofile-open-api/pull/268) [280](https://github.com/eclipse/microprofile-open-api/pull/280)\r\n- [ ] Delegate document / property location to MP Config \r\n    Links: [Arch Board 46](https://github.com/eclipse/microprofile/issues/46)\r\n- [ ] (#240) All getters returning a list or a map MUST return copy of this list/map containing the same items. This list/map CAN be immutable\r\n- [ ] (#284) The setters having a list or a map as parameter MUST not use the list/map instance directly (it can be for example an immutable list/map)"},"comment":{"url":"https://api.github.com/repos/eclipse/microprofile-open-api/issues/comments/442157779","html_url":"https://github.com/eclipse/microprofile-open-api/issues/251#issuecomment-442157779","issue_url":"https://api.github.com/repos/eclipse/microprofile-open-api/issues/251","id":442157779,"node_id":"MDEyOklzc3VlQ29tbWVudDQ0MjE1Nzc3OQ==","user":{"login":"arthurdm","id":5042215,"node_id":"MDQ6VXNlcjUwNDIyMTU=","avatar_url":"https://avatars0.githubusercontent.com/u/5042215?v=4","gravatar_id":"","url":"https://api.github.com/users/arthurdm","html_url":"https://github.com/arthurdm","followers_url":"https://api.github.com/users/arthurdm/followers","following_url":"https://api.github.com/users/arthurdm/following{/other_user}","gists_url":"https://api.github.com/users/arthurdm/gists{/gist_id}","starred_url":"https://api.github.com/users/arthurdm/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/arthurdm/subscriptions","organizations_url":"https://api.github.com/users/arthurdm/orgs","repos_url":"https://api.github.com/users/arthurdm/repos","events_url":"https://api.github.com/users/arthurdm/events{/privacy}","received_events_url":"https://api.github.com/users/arthurdm/received_events","type":"User","site_admin":false},"created_at":"2018-11-27T18:02:41Z","updated_at":"2018-11-27T18:02:41Z","author_association":"MEMBER","body":"I would like to throw in the idea of removing `OASFilter` and `OASModeReader` from the spec in the `2.0` version.   The benefits would be an easier-to-understand spec, and would allow full compatibility with an `offline` (via Maven or other) generation of the OAS3 doc.  \r\n\r\nI believe that modern usage of OAS3 is either via top-down / design-first, where you have the doc generated by a design team, or bottom-up / code-first, where the developer iteratively works on the JAX-RS app, generating it every time. \r\n\r\n In both cases there is a point in time where development is frozen and no more changes to the API should be allowed.   Therefore, why would we want to use a dynamic filter or model builder?     The only dynamic setting I can reasonably accept are changes to the `server` element, which can already be achieved by configuring the `mp.openapi.servers.*` related keys via MP Config.\r\n\r\nThoughts?"}}
{"actor":{"display_login":"arthurdm"}}