amol- commented on pull request #11726: URL: https://github.com/apache/arrow/pull/11726#issuecomment-979193684
> I was thinking we could maybe also use numpydoc for our docstring rendering. They also support making the return type into a clickable link, but generalize this to parameter types as well (and it doesn't result in the duplicate "Returns" issue you mentioned above). See eg https://numpydoc.readthedocs.io/en/latest/example.html#module-example I did a quick test and it seems to work. The only thing I'm not confident with is that it seems doc was moved from `numpydoc` to `napeoleon` in the past ( https://github.com/apache/arrow/pull/208/files ) to fix some build issues. @xhochy might know more about what lead to that change and if there is any risk in going back to numpydoc -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
