<div dir="ltr"><div dir="ltr"><br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Tue, Jul 16, 2019 at 4:23 AM Gael Varoquaux <<a href="mailto:gael.varoquaux@normalesup.org">gael.varoquaux@normalesup.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">> The one thing I worry about is maintenance burden, where numpydoc is already<br>
> spread a little bit thin -- would any of the Pandas developers be willing to<br>
> maintain it?<br>
<br>
Any reason that this is not done in sphinx, with the napoleon extension?<br>
<a href="https://www.sphinx-doc.org/en/master/usage/extensions/napoleon.html" rel="noreferrer" target="_blank">https://www.sphinx-doc.org/en/master/usage/extensions/napoleon.html</a><br>
<br>
I would hope that this can increase the number of people likely to help<br>
maintaining.<br></blockquote><div><br></div><div>Just history. Numpydoc came first, most projects rely on it. Napoleon came way later and then did its own numpy docstring support rather than contribute to numpydoc or propose a merge. <br></div><div><br></div><div>If someone wants to figure out how compatible these two implementations are and whether they can be merged, that would be really welcome.</div><div><br></div><div>Cheers,<br></div><div>Ralf</div><div><br></div></div></div>