{"action":"created","issue":{"url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/662","repository_url":"https://api.github.com/repos/OAI/OpenAPI-Specification","labels_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/662/labels{/name}","comments_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/662/comments","events_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/662/events","html_url":"https://github.com/OAI/OpenAPI-Specification/issues/662","id":149545927,"number":662,"title":"Provide a Contributing.md guide for TDC and others","user":{"login":"DavidBiesack","id":545944,"avatar_url":"https://avatars.githubusercontent.com/u/545944?v=3","gravatar_id":"","url":"https://api.github.com/users/DavidBiesack","html_url":"https://github.com/DavidBiesack","followers_url":"https://api.github.com/users/DavidBiesack/followers","following_url":"https://api.github.com/users/DavidBiesack/following{/other_user}","gists_url":"https://api.github.com/users/DavidBiesack/gists{/gist_id}","starred_url":"https://api.github.com/users/DavidBiesack/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/DavidBiesack/subscriptions","organizations_url":"https://api.github.com/users/DavidBiesack/orgs","repos_url":"https://api.github.com/users/DavidBiesack/repos","events_url":"https://api.github.com/users/DavidBiesack/events{/privacy}","received_events_url":"https://api.github.com/users/DavidBiesack/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2016-04-19T18:35:58Z","updated_at":"2016-04-19T18:57:27Z","closed_at":null,"body":"This project would benefit some guidance on how the Technical Development Community can/should contribute. See [this comment](https://github.com/OAI/OpenAPI-Specification/pull/464#issuecomment-212046485) for example:\r\n\r\n> Could you rebase your Pull request against current master (or maybe even better, current OpenAPI.next)? There the specs are in the versions folder.\r\n\r\nA [Contributing.md](https://github.com/OAI/OpenAPI-Specification/blob/master/Contributing.md) guide (linked to from the README.md page) would contain information such as (these are suggestions) what branches should be used for pull requests for OAS 3.0 (**[OpenAPI.next](https://github.com/OAI/OpenAPI-Specification/tree/OpenAPI.next)**?), what constitutes a good pull request, what tags one should use for issues and what those tags mean (with links to the issues, by tag such as **[OpenAPI.Next Proposal](https://github.com/OAI/OpenAPI-Specification/issues?q=is%3Aissue+is%3Aopen+label%3A%22OpenAPI.Next+Proposal%22)**), what is the workflow/process that the OAI and committers uses for evaluating proposals and pull requests, who the principal committers are and what their roles are, etc. Some of this info (OAI etc.) may be located elsewhere but links to such material would be sufficient.\r\n\r\nA central guide such as this on this GitHub project would really help the TDC."},"comment":{"url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/comments/212068551","html_url":"https://github.com/OAI/OpenAPI-Specification/issues/662#issuecomment-212068551","issue_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/662","id":212068551,"user":{"login":"ePaul","id":645859,"avatar_url":"https://avatars.githubusercontent.com/u/645859?v=3","gravatar_id":"","url":"https://api.github.com/users/ePaul","html_url":"https://github.com/ePaul","followers_url":"https://api.github.com/users/ePaul/followers","following_url":"https://api.github.com/users/ePaul/following{/other_user}","gists_url":"https://api.github.com/users/ePaul/gists{/gist_id}","starred_url":"https://api.github.com/users/ePaul/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ePaul/subscriptions","organizations_url":"https://api.github.com/users/ePaul/orgs","repos_url":"https://api.github.com/users/ePaul/repos","events_url":"https://api.github.com/users/ePaul/events{/privacy}","received_events_url":"https://api.github.com/users/ePaul/received_events","type":"User","site_admin":false},"created_at":"2016-04-19T18:57:27Z","updated_at":"2016-04-19T18:57:27Z","body":"The good thing about having a CONTRIBUTING.md file is that [Github links it from the issue (or pull request) creation form](https://github.com/blog/1184-contributing-guidelines)."}}