{"action":"created","issue":{"url":"https://api.github.com/repos/commercialhaskell/stack/issues/923","labels_url":"https://api.github.com/repos/commercialhaskell/stack/issues/923/labels{/name}","comments_url":"https://api.github.com/repos/commercialhaskell/stack/issues/923/comments","events_url":"https://api.github.com/repos/commercialhaskell/stack/issues/923/events","html_url":"https://github.com/commercialhaskell/stack/pull/923","id":104928087,"number":923,"title":"initial restructuring of docs and barebones inclusion of other tools re: commercialhaskell/stack#894","user":{"login":"kairuku","id":7062385,"avatar_url":"https://avatars.githubusercontent.com/u/7062385?v=3","gravatar_id":"","url":"https://api.github.com/users/kairuku","html_url":"https://github.com/kairuku","followers_url":"https://api.github.com/users/kairuku/followers","following_url":"https://api.github.com/users/kairuku/following{/other_user}","gists_url":"https://api.github.com/users/kairuku/gists{/gist_id}","starred_url":"https://api.github.com/users/kairuku/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kairuku/subscriptions","organizations_url":"https://api.github.com/users/kairuku/orgs","repos_url":"https://api.github.com/users/kairuku/repos","events_url":"https://api.github.com/users/kairuku/events{/privacy}","received_events_url":"https://api.github.com/users/kairuku/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2015-09-04T16:54:26Z","updated_at":"2015-09-06T21:52:08Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/commercialhaskell/stack/pulls/923","html_url":"https://github.com/commercialhaskell/stack/pull/923","diff_url":"https://github.com/commercialhaskell/stack/pull/923.diff","patch_url":"https://github.com/commercialhaskell/stack/pull/923.patch"},"body":"-- creates new directory structure for documentation, aiming for smaller topic-based files and\r\n   limiting repetition of content as much as possible (could potentially use table of content\r\n   files to point to these, and potentially further nest groups of related topic files into new\r\n   subdirectories, letting the \"toc\" files hide this organizational detail)\r\n\r\n-- creates a separate doc for motivation behind stack, tools comparison, and future roadmap\r\n\r\n-- pulls the \"why\" section out of the readme and the \"comparison\" section out of the guide,\r\n   moving these both to the new document mentioned above\r\n\r\n-- moves as much as possible among documentation-esque files from the root directory of the repo\r\n   into the new docs directory, leaving only the readme in the top level directory\r\n\r\n-- edits readme to point to the new document (URLs will need to be fixed in a subsequent commit)\r\n\r\n-- divides docs directory into subdirectories for maintainer docs, and docs for everyone\r\n   (inspired initially by a \"release\" document found elsewhere in the repo)\r\n\r\n-- creates suggested stub directories for haddocks and man pages, but nothing has been moved here\r\n   (one idea is that haddocks placed here with all the other documentation could be rsynced to any\r\n   \"dist\" directory during any build process if needed)\r\n\r\n-- creates suggested example stub file for wiki migration (assuming this is a desirable paradigm),\r\n   specifically a \"faq\" file"},"comment":{"url":"https://api.github.com/repos/commercialhaskell/stack/issues/comments/138128883","html_url":"https://github.com/commercialhaskell/stack/pull/923#issuecomment-138128883","issue_url":"https://api.github.com/repos/commercialhaskell/stack/issues/923","id":138128883,"user":{"login":"kairuku","id":7062385,"avatar_url":"https://avatars.githubusercontent.com/u/7062385?v=3","gravatar_id":"","url":"https://api.github.com/users/kairuku","html_url":"https://github.com/kairuku","followers_url":"https://api.github.com/users/kairuku/followers","following_url":"https://api.github.com/users/kairuku/following{/other_user}","gists_url":"https://api.github.com/users/kairuku/gists{/gist_id}","starred_url":"https://api.github.com/users/kairuku/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kairuku/subscriptions","organizations_url":"https://api.github.com/users/kairuku/orgs","repos_url":"https://api.github.com/users/kairuku/repos","events_url":"https://api.github.com/users/kairuku/events{/privacy}","received_events_url":"https://api.github.com/users/kairuku/received_events","type":"User","site_admin":false},"created_at":"2015-09-06T21:52:08Z","updated_at":"2015-09-06T21:52:08Z","body":"ref [#894](https://github.com/commercialhaskell/stack/issues/894)"}}