<div dir="ltr">I see that the task has not had any activity for a while. It would be good to nail this down. I asked a question on the task about how we plan to do the conversion, and I think it's important to answer that before we commit to the change.<div><br></div><div><a href="https://pulp.plan.io/issues/2347#note-12">https://pulp.plan.io/issues/2347#note-12</a><br></div><div><br></div><div>It appears that in a couple of places, the Google style has already been employed. To my knowledge, no decision has been made yet, nor do I think we should make a change like this until we have a plan in place and all questions answered. I don't see any reason why we can't make a plan and move forward, but let's please proceed with an orderly transition.</div><div><br></div><div>Perhaps one or more people who are particularly interested in this change would be willing to take the reigns and try to get this task groomed and accepted onto the next sprint. Any volunteers?</div><div><br></div><div>Thanks,</div><div>Michael</div></div><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Oct 27, 2016 at 12:53 PM, Brian Bouterse <span dir="ltr"><<a href="mailto:bbouters@redhat.com" target="_blank">bbouters@redhat.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><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" target="_blank">https://pulp.plan.io/issues/<wbr>2347</a><br><br></div><div class="HOEnZb"><div class="h5"><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="m_-1693050062943266042HOEnZb"><div class="m_-1693050062943266042h5"><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/s<wbr>table/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="m_-1693050062943266042HOEnZb"><div class="m_-1693050062943266042h5">> ______________________________<wbr>_________________<br>
> Pulp-dev mailing list<br>
> <a href="mailto:Pulp-dev@redhat.com" target="_blank">Pulp-dev@redhat.com</a><br>
> <a href="https://www.redhat.com/mailman/listinfo/pulp-dev" rel="noreferrer" target="_blank">https://www.redhat.com/mailman<wbr>/listinfo/pulp-dev</a><br>
><br>
<br>
</div></div><br>______________________________<wbr>_________________<br>
Pulp-dev mailing list<br>
<a href="mailto:Pulp-dev@redhat.com" target="_blank">Pulp-dev@redhat.com</a><br>
<a href="https://www.redhat.com/mailman/listinfo/pulp-dev" rel="noreferrer" target="_blank">https://www.redhat.com/mailman<wbr>/listinfo/pulp-dev</a><br>
<br></blockquote></div><br></div>
</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>