{"action":"reopened","issue":{"url":"https://api.github.com/repos/rubik/mando/issues/21","repository_url":"https://api.github.com/repos/rubik/mando","labels_url":"https://api.github.com/repos/rubik/mando/issues/21/labels{/name}","comments_url":"https://api.github.com/repos/rubik/mando/issues/21/comments","events_url":"https://api.github.com/repos/rubik/mando/issues/21/events","html_url":"https://github.com/rubik/mando/issues/21","id":134326103,"number":21,"title":"Sphinx for docstring translation and processing?","user":{"login":"timcera","id":297142,"avatar_url":"https://avatars.githubusercontent.com/u/297142?v=3","gravatar_id":"","url":"https://api.github.com/users/timcera","html_url":"https://github.com/timcera","followers_url":"https://api.github.com/users/timcera/followers","following_url":"https://api.github.com/users/timcera/following{/other_user}","gists_url":"https://api.github.com/users/timcera/gists{/gist_id}","starred_url":"https://api.github.com/users/timcera/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/timcera/subscriptions","organizations_url":"https://api.github.com/users/timcera/orgs","repos_url":"https://api.github.com/users/timcera/repos","events_url":"https://api.github.com/users/timcera/events{/privacy}","received_events_url":"https://api.github.com/users/timcera/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":7,"created_at":"2016-02-17T16:16:29Z","updated_at":"2016-03-14T14:20:53Z","closed_at":null,"body":"Sphinx can translate Google and Numpy formatted docstrings into reStructuredText format.  See http://www.sphinx-doc.org/en/stable/ext/napoleon.html.  I think mando could also transfer other parts of the docstring processing of the reStructuredText to Sphinx.\r\n\r\nIf you think it would be a good idea then:\r\n    Should Sphinx be a prerequisite?\r\nOR\r\n    Should we just take the code we need from Sphinx and keep with mando.\r\n\r\nIf Sphinx is a prerequisite then mando could take advantage of any improvements or bug fixes, but it is a pretty hefty library to carry around.  I always have it installed anyway, but it is unlikely to be installed for most users (or is it?).  This would be the easiest approach - but you would have to accept the idea of having a prerequisite.\r\n\r\nI have started taking from Sphinx and including just the Google/Numpy translation feature into mando.  Lots of problems with this approach because there are many connections to other parts of the Sphinx ecosystem, and you have to track them all down. Also someone has to take care of that code once it is brought over.  Perhaps not often, but it might mean folding in complicated changes or bug fixes from Sphinx.  Before I put any more work into it however, I wanted to run the idea past you.\r\n"}}