{"action":"created","issue":{"url":"https://api.github.com/repos/pypa/pypa.io/issues/11","repository_url":"https://api.github.com/repos/pypa/pypa.io","labels_url":"https://api.github.com/repos/pypa/pypa.io/issues/11/labels{/name}","comments_url":"https://api.github.com/repos/pypa/pypa.io/issues/11/comments","events_url":"https://api.github.com/repos/pypa/pypa.io/issues/11/events","html_url":"https://github.com/pypa/pypa.io/issues/11","id":127369754,"number":11,"title":"Migrating interoperability specifications to PyPUG","user":{"login":"ncoghlan","id":1026649,"avatar_url":"https://avatars.githubusercontent.com/u/1026649?v=3","gravatar_id":"","url":"https://api.github.com/users/ncoghlan","html_url":"https://github.com/ncoghlan","followers_url":"https://api.github.com/users/ncoghlan/followers","following_url":"https://api.github.com/users/ncoghlan/following{/other_user}","gists_url":"https://api.github.com/users/ncoghlan/gists{/gist_id}","starred_url":"https://api.github.com/users/ncoghlan/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ncoghlan/subscriptions","organizations_url":"https://api.github.com/users/ncoghlan/orgs","repos_url":"https://api.github.com/users/ncoghlan/repos","events_url":"https://api.github.com/users/ncoghlan/events{/privacy}","received_events_url":"https://api.github.com/users/ncoghlan/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":{"login":"ncoghlan","id":1026649,"avatar_url":"https://avatars.githubusercontent.com/u/1026649?v=3","gravatar_id":"","url":"https://api.github.com/users/ncoghlan","html_url":"https://github.com/ncoghlan","followers_url":"https://api.github.com/users/ncoghlan/followers","following_url":"https://api.github.com/users/ncoghlan/following{/other_user}","gists_url":"https://api.github.com/users/ncoghlan/gists{/gist_id}","starred_url":"https://api.github.com/users/ncoghlan/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ncoghlan/subscriptions","organizations_url":"https://api.github.com/users/ncoghlan/orgs","repos_url":"https://api.github.com/users/ncoghlan/repos","events_url":"https://api.github.com/users/ncoghlan/events{/privacy}","received_events_url":"https://api.github.com/users/ncoghlan/received_events","type":"User","site_admin":false},"milestone":null,"comments":8,"created_at":"2016-01-19T05:34:02Z","updated_at":"2016-03-11T15:24:08Z","closed_at":null,"body":"I have some time at the moment to work on upstream process improvement, and one of the things I'd like to tidy up is the change management process for interoperability specifications. Some relevant previous discussions:\r\n\r\n* PyPA, PEPs & BDFL-Delegates: https://mail.python.org/pipermail/distutils-sig/2015-September/026810.html\r\n* Potentially moving away from PEPs as the primary spec reference URLs: https://mail.python.org/pipermail/distutils-sig/2015-April/026206.html\r\n* Including more user centric summaries of the specifications in the packaging user guide: https://github.com/pypa/python-packaging-user-guide/issues/151\r\n\r\nSince that last discussion, @dstufft, @nlhkabu and @ddbeck have done a lot more design work on Warehouse and the user guide, so I've now come around to the view that the PyPA internal docs are likely to be a better home.\r\n\r\nRather than using PEP 440 or PEP 508 as guinea pigs, I'm thinking a better starting point might be PEP 376 (the database of installed Python distributions), since we can tweak the description on pypa.io to specifically cover the interoperability spec parts that pip implements, and omit the standard library API parts.\r\n\r\nI'll put together a pull request along those lines, adding a new \"PyPA Specifications\" section, with process details (based on the first email linked above), and a section on the RECORD file and the directory naming scheme."},"comment":{"url":"https://api.github.com/repos/pypa/pypa.io/issues/comments/195412332","html_url":"https://github.com/pypa/pypa.io/issues/11#issuecomment-195412332","issue_url":"https://api.github.com/repos/pypa/pypa.io/issues/11","id":195412332,"user":{"login":"ncoghlan","id":1026649,"avatar_url":"https://avatars.githubusercontent.com/u/1026649?v=3","gravatar_id":"","url":"https://api.github.com/users/ncoghlan","html_url":"https://github.com/ncoghlan","followers_url":"https://api.github.com/users/ncoghlan/followers","following_url":"https://api.github.com/users/ncoghlan/following{/other_user}","gists_url":"https://api.github.com/users/ncoghlan/gists{/gist_id}","starred_url":"https://api.github.com/users/ncoghlan/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ncoghlan/subscriptions","organizations_url":"https://api.github.com/users/ncoghlan/orgs","repos_url":"https://api.github.com/users/ncoghlan/repos","events_url":"https://api.github.com/users/ncoghlan/events{/privacy}","received_events_url":"https://api.github.com/users/ncoghlan/received_events","type":"User","site_admin":false},"created_at":"2016-03-11T15:24:08Z","updated_at":"2016-03-11T15:24:08Z","body":"Next steps:\r\n\r\n- [ ] update the process description to allow errata & minor amendments to be handled as PyPUG issues and pull requests, rather than full PEPs\r\n- [ ] update the PEPs themselves with links pointing to the appropriate section in https://packaging.python.org/en/latest/specifications/ for errata & amendments "}}