{"action":"created","issue":{"url":"https://api.github.com/repos/fog/fog/issues/3508","labels_url":"https://api.github.com/repos/fog/fog/issues/3508/labels{/name}","comments_url":"https://api.github.com/repos/fog/fog/issues/3508/comments","events_url":"https://api.github.com/repos/fog/fog/issues/3508/events","html_url":"https://github.com/fog/fog/issues/3508","id":65718796,"number":3508,"title":"Design Document for planned v2.0.0 changes","user":{"login":"ihmccreery","id":368416,"avatar_url":"https://avatars.githubusercontent.com/u/368416?v=3","gravatar_id":"","url":"https://api.github.com/users/ihmccreery","html_url":"https://github.com/ihmccreery","followers_url":"https://api.github.com/users/ihmccreery/followers","following_url":"https://api.github.com/users/ihmccreery/following{/other_user}","gists_url":"https://api.github.com/users/ihmccreery/gists{/gist_id}","starred_url":"https://api.github.com/users/ihmccreery/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ihmccreery/subscriptions","organizations_url":"https://api.github.com/users/ihmccreery/orgs","repos_url":"https://api.github.com/users/ihmccreery/repos","events_url":"https://api.github.com/users/ihmccreery/events{/privacy}","received_events_url":"https://api.github.com/users/ihmccreery/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":3,"created_at":"2015-04-01T16:02:50Z","updated_at":"2015-04-01T23:56:45Z","closed_at":null,"body":"(First off, @tokengeek, is the title of this issue right?)\r\n\r\nPer discussion and @tokengeek's idea in #3504, this is a request for the updating of documentation and the writing of a design document for v2.0.0.  A rough outline of what I think it should include, with amendments and additions more than welcome:\r\n\r\n1. clear documentation of where the codebase is now and the major issues we're facing, though this might just reference CONTRIBUTING.md;\r\n1. discussion of each major architectural change we're making, including\r\n  - motivation, (likely referencing the section above,)\r\n  - planned execution,\r\n  - current questions, and\r\n  - references to discussions where these were decided;\r\n1. notes for contributors about what they should expect and/or strive for when writing new code."},"comment":{"url":"https://api.github.com/repos/fog/fog/issues/comments/88668828","html_url":"https://github.com/fog/fog/issues/3508#issuecomment-88668828","issue_url":"https://api.github.com/repos/fog/fog/issues/3508","id":88668828,"user":{"login":"ihmccreery","id":368416,"avatar_url":"https://avatars.githubusercontent.com/u/368416?v=3","gravatar_id":"","url":"https://api.github.com/users/ihmccreery","html_url":"https://github.com/ihmccreery","followers_url":"https://api.github.com/users/ihmccreery/followers","following_url":"https://api.github.com/users/ihmccreery/following{/other_user}","gists_url":"https://api.github.com/users/ihmccreery/gists{/gist_id}","starred_url":"https://api.github.com/users/ihmccreery/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ihmccreery/subscriptions","organizations_url":"https://api.github.com/users/ihmccreery/orgs","repos_url":"https://api.github.com/users/ihmccreery/repos","events_url":"https://api.github.com/users/ihmccreery/events{/privacy}","received_events_url":"https://api.github.com/users/ihmccreery/received_events","type":"User","site_admin":false},"created_at":"2015-04-01T23:56:45Z","updated_at":"2015-04-01T23:56:45Z","body":"@geemus Thanks.  I know this is a big project, and I don't expect it to all happen at once.\r\n\r\nFor a stop-gap, may I at least add notes about the following to CONTRIBUTING:\r\n\r\n- a lot of things are moving, (what things?  I know about the meta-gem movement, the change in testing framework, and the mocking question; are there are other big ones?)\r\n- there's a chicken-and-egg problem with documentation, and\r\n- that the documentation is somewhat out of date\r\n\r\nand put references to the above GitHub issues?"}}