{"action":"created","issue":{"url":"https://api.github.com/repos/GMOD/Apollo/issues/191","labels_url":"https://api.github.com/repos/GMOD/Apollo/issues/191/labels{/name}","comments_url":"https://api.github.com/repos/GMOD/Apollo/issues/191/comments","events_url":"https://api.github.com/repos/GMOD/Apollo/issues/191/events","html_url":"https://github.com/GMOD/Apollo/pull/191","id":60374932,"number":191,"title":"Use sphinx for documentation (allows pdf export, etc)","user":{"login":"cmdcolin","id":6511937,"avatar_url":"https://avatars.githubusercontent.com/u/6511937?v=3","gravatar_id":"","url":"https://api.github.com/users/cmdcolin","html_url":"https://github.com/cmdcolin","followers_url":"https://api.github.com/users/cmdcolin/followers","following_url":"https://api.github.com/users/cmdcolin/following{/other_user}","gists_url":"https://api.github.com/users/cmdcolin/gists{/gist_id}","starred_url":"https://api.github.com/users/cmdcolin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cmdcolin/subscriptions","organizations_url":"https://api.github.com/users/cmdcolin/orgs","repos_url":"https://api.github.com/users/cmdcolin/repos","events_url":"https://api.github.com/users/cmdcolin/events{/privacy}","received_events_url":"https://api.github.com/users/cmdcolin/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/GMOD/Apollo/labels/enhancement","name":"enhancement","color":"84b6eb"}],"state":"closed","locked":false,"assignee":null,"milestone":{"url":"https://api.github.com/repos/GMOD/Apollo/milestones/13","html_url":"https://github.com/GMOD/Apollo/milestones/2.0.1","labels_url":"https://api.github.com/repos/GMOD/Apollo/milestones/13/labels","id":1059255,"number":13,"title":"2.0.1","description":"","creator":{"login":"nathandunn","id":751274,"avatar_url":"https://avatars.githubusercontent.com/u/751274?v=3","gravatar_id":"","url":"https://api.github.com/users/nathandunn","html_url":"https://github.com/nathandunn","followers_url":"https://api.github.com/users/nathandunn/followers","following_url":"https://api.github.com/users/nathandunn/following{/other_user}","gists_url":"https://api.github.com/users/nathandunn/gists{/gist_id}","starred_url":"https://api.github.com/users/nathandunn/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/nathandunn/subscriptions","organizations_url":"https://api.github.com/users/nathandunn/orgs","repos_url":"https://api.github.com/users/nathandunn/repos","events_url":"https://api.github.com/users/nathandunn/events{/privacy}","received_events_url":"https://api.github.com/users/nathandunn/received_events","type":"User","site_admin":false},"open_issues":42,"closed_issues":9,"state":"open","created_at":"2015-04-08T21:05:39Z","updated_at":"2015-07-15T03:16:14Z","due_on":"2015-07-31T07:00:00Z","closed_at":null},"comments":8,"created_at":"2015-03-09T16:57:52Z","updated_at":"2015-07-15T16:35:51Z","closed_at":"2015-07-15T03:16:14Z","pull_request":{"url":"https://api.github.com/repos/GMOD/Apollo/pulls/191","html_url":"https://github.com/GMOD/Apollo/pull/191","diff_url":"https://github.com/GMOD/Apollo/pull/191.diff","patch_url":"https://github.com/GMOD/Apollo/pull/191.patch"},"body":"I wanted to propose converting our documentation to Sphinx instead of Markdown. Readthedocs basically supports Markdown and Sphinx, but only Sphinx allows nice PDF generation.\r\n\r\nI ran pandoc to convert our existing documentation to Sphinx and it generated a PDF and just doing that makes our docs looks very nice. Please see this link for a preview\r\n\r\nhttps://www.dropbox.com/s/31er7sfidoq5whw/WebApollo.pdf?dl=0\r\n\r\n\r\nThe conversion to sphinx isn't 100% complete, in particular parts of the document that link between sections aren't done yet, so this still needs a little touching up"},"comment":{"url":"https://api.github.com/repos/GMOD/Apollo/issues/comments/121671423","html_url":"https://github.com/GMOD/Apollo/pull/191#issuecomment-121671423","issue_url":"https://api.github.com/repos/GMOD/Apollo/issues/191","id":121671423,"user":{"login":"nathandunn","id":751274,"avatar_url":"https://avatars.githubusercontent.com/u/751274?v=3","gravatar_id":"","url":"https://api.github.com/users/nathandunn","html_url":"https://github.com/nathandunn","followers_url":"https://api.github.com/users/nathandunn/followers","following_url":"https://api.github.com/users/nathandunn/following{/other_user}","gists_url":"https://api.github.com/users/nathandunn/gists{/gist_id}","starred_url":"https://api.github.com/users/nathandunn/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/nathandunn/subscriptions","organizations_url":"https://api.github.com/users/nathandunn/orgs","repos_url":"https://api.github.com/users/nathandunn/repos","events_url":"https://api.github.com/users/nathandunn/events{/privacy}","received_events_url":"https://api.github.com/users/nathandunn/received_events","type":"User","site_admin":false},"created_at":"2015-07-15T16:35:51Z","updated_at":"2015-07-15T16:35:51Z","body":"\nAm still open to doing it in 2.0.X . . .  It seems like RST is more powerful (esp. for readthedocs) but markdown is far more ubiquitous / wiki-like and less lisp-like.   Though you are right, keeping markdown is probably best.  \n\nNathan\n\n> On Jul 14, 2015, at 8:14 PM, Colin Diesh <notifications@github.com> wrote:\n> \n> The developers on readthedocs said that they might be possible to process plain old markdown with sphinx instead of converting everything to restructured text. Example\n> \n> https://github.com/ericholscher/sphinx-markdown-test <https://github.com/ericholscher/sphinx-markdown-test>\n> https://media.readthedocs.org/pdf/sphinx-markdown-test/latest/sphinx-markdown-test.pdf <https://media.readthedocs.org/pdf/sphinx-markdown-test/latest/sphinx-markdown-test.pdf>\n> So, I guess we can stick with markdown for now. RST does have some advantages (it seems a little more \"strongly\" formatted than markdown is which is kind of nice) but maybe not enough to switch to it\n> \n> —\n> Reply to this email directly or view it on GitHub <https://github.com/GMOD/Apollo/pull/191#issuecomment-121471282>.\n> \n\n"}}