{"action":"created","issue":{"url":"https://api.github.com/repos/stubailo/meteor-rest/issues/49","labels_url":"https://api.github.com/repos/stubailo/meteor-rest/issues/49/labels{/name}","comments_url":"https://api.github.com/repos/stubailo/meteor-rest/issues/49/comments","events_url":"https://api.github.com/repos/stubailo/meteor-rest/issues/49/events","html_url":"https://github.com/stubailo/meteor-rest/pull/49","id":85670737,"number":49,"title":"Moving docs onto ReadTheDocs.org","user":{"login":"stubailo","id":448783,"avatar_url":"https://avatars.githubusercontent.com/u/448783?v=3","gravatar_id":"","url":"https://api.github.com/users/stubailo","html_url":"https://github.com/stubailo","followers_url":"https://api.github.com/users/stubailo/followers","following_url":"https://api.github.com/users/stubailo/following{/other_user}","gists_url":"https://api.github.com/users/stubailo/gists{/gist_id}","starred_url":"https://api.github.com/users/stubailo/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/stubailo/subscriptions","organizations_url":"https://api.github.com/users/stubailo/orgs","repos_url":"https://api.github.com/users/stubailo/repos","events_url":"https://api.github.com/users/stubailo/events{/privacy}","received_events_url":"https://api.github.com/users/stubailo/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2015-06-06T01:27:48Z","updated_at":"2015-07-22T16:18:07Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/stubailo/meteor-rest/pulls/49","html_url":"https://github.com/stubailo/meteor-rest/pull/49","diff_url":"https://github.com/stubailo/meteor-rest/pull/49.diff","patch_url":"https://github.com/stubailo/meteor-rest/pull/49.patch"},"body":"Currently a work in progress, I'm just testing migrating one page.\r\n\r\nSample page: http://meteor-rest.readthedocs.org/en/rtd/rest/\r\n\r\nTodo:\r\n- [ ] Make edit on GitHub link actually link to editing, or change link to say \"View on GitHub\" https://github.com/mkdocs/mkdocs/issues/269\r\n\r\nBenefits:\r\n- Automatic table of contents/navigation between pages (right now this is GitHub's biggest problem, navigating between READMEs is not great)\r\n- Ability to switch versions automatically (not sure how this will work out with switching versions)\r\n- The default branch on our repo right now is `devel`, and the docs there will probably not be in sync with what is actually released\r\n- Clicking on README links on Atmosphere totally sucks, so it would be great to easily link to a docs site from there\r\n- Ability to modify the CSS to improve readability\r\n- Easy search\r\n- Decoupling of docs pages and READMEs\r\n\r\nDrawbacks:\r\n- Some text will be duplicated between READMEs and the docs site\r\n\r\n@aldeed @kahmali what do you think? Is this a good idea? Am I missing some drawbacks to using that site instead of GitHub READMEs?"},"comment":{"url":"https://api.github.com/repos/stubailo/meteor-rest/issues/comments/123777633","html_url":"https://github.com/stubailo/meteor-rest/pull/49#issuecomment-123777633","issue_url":"https://api.github.com/repos/stubailo/meteor-rest/issues/49","id":123777633,"user":{"login":"tormi","id":146800,"avatar_url":"https://avatars.githubusercontent.com/u/146800?v=3","gravatar_id":"","url":"https://api.github.com/users/tormi","html_url":"https://github.com/tormi","followers_url":"https://api.github.com/users/tormi/followers","following_url":"https://api.github.com/users/tormi/following{/other_user}","gists_url":"https://api.github.com/users/tormi/gists{/gist_id}","starred_url":"https://api.github.com/users/tormi/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tormi/subscriptions","organizations_url":"https://api.github.com/users/tormi/orgs","repos_url":"https://api.github.com/users/tormi/repos","events_url":"https://api.github.com/users/tormi/events{/privacy}","received_events_url":"https://api.github.com/users/tormi/received_events","type":"User","site_admin":false},"created_at":"2015-07-22T16:18:07Z","updated_at":"2015-07-22T16:18:07Z","body":"https://www.gitbook.com/ is another option, it has github integration as well: https://www.gitbook.com/blog/features/import-github"}}