<div dir="ltr">Also +1. Is this story ready to be groomed and marked as a sprint candidate=yes?<br><br><a href="https://pulp.plan.io/issues/2347">https://pulp.plan.io/issues/2347</a><br><br></div><div class="gmail_extra"><br><div class="gmail_quote">On Wed, Oct 26, 2016 at 5:07 PM, Jeff Ortel <span dir="ltr"><<a href="mailto:jortel@redhat.com" target="_blank">jortel@redhat.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">+1 switching to Napoleon.<br>
<div class="HOEnZb"><div class="h5"><br>
On 10/17/2016 10:14 AM, Sean Myers wrote:<br>
> I'd love it if we could stop writing docs in the ":param foo:" style. Instead,<br>
> I think that we should use the sphinx extension "napoleon" to write docstrings<br>
> that are *way* more human-readable (in my opinion, at least) while still<br>
> generating good sphinx docs.<br>
><br>
> I think Napoleon's page in the sphinx docs explain this pretty well:<br>
> <a href="http://www.sphinx-doc.org/en/stable/ext/napoleon.html" rel="noreferrer" target="_blank">http://www.sphinx-doc.org/en/<wbr>stable/ext/napoleon.html</a><br>
><br>
> I've got like three more RFCs queued up; I'm trying to be nice and not overload<br>
> pulp-dev with all my crazy ideas simultaneously. :)<br>
><br>
><br>
><br>
</div></div><div class="HOEnZb"><div class="h5">> ______________________________<wbr>_________________<br>
> Pulp-dev mailing list<br>
> <a href="mailto:Pulp-dev@redhat.com">Pulp-dev@redhat.com</a><br>
> <a href="https://www.redhat.com/mailman/listinfo/pulp-dev" rel="noreferrer" target="_blank">https://www.redhat.com/<wbr>mailman/listinfo/pulp-dev</a><br>
><br>
<br>
</div></div><br>______________________________<wbr>_________________<br>
Pulp-dev mailing list<br>
<a href="mailto:Pulp-dev@redhat.com">Pulp-dev@redhat.com</a><br>
<a href="https://www.redhat.com/mailman/listinfo/pulp-dev" rel="noreferrer" target="_blank">https://www.redhat.com/<wbr>mailman/listinfo/pulp-dev</a><br>
<br></blockquote></div><br></div>