<div dir="ltr">It's hard to say "yes" with a variable-width font, but here's an example of what I find very readable:<div><br></div><div><a href="https://github.com/pulp/crane/blob/2.0.0/crane/views/v1.py#L173-L179">https://github.com/pulp/crane/blob/2.0.0/crane/views/v1.py#L173-L179</a><br></div><div><br></div><div>I like information in tables and have spent too much of my life in spreadsheets, so that could be causing an aesthetic bias. :)</div><div><br></div><div>Michael</div></div><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Oct 17, 2016 at 2:43 PM, Sean Myers <span dir="ltr"><<a href="mailto:sean.myers@redhat.com" target="_blank">sean.myers@redhat.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">On 10/17/2016 02:32 PM, Michael Hrivnak wrote:<br>
> I personally find their RST example to be a "jumble" only because the<br>
> second column isn't aligned. I find the RST style to be easier to read than<br>
> Napoleon when it's correctly aligned, although admittedly it does take a<br>
> small amount of effort to keep it aligned. Both are fine options, and I'd<br>
> be quite happy either way.<br>
<br>
</span>To be clear, you're saying that this...<br>
<br>
    """<br>
    Fields:<br>
<br>
    :cvar url: The URL used to download the related artifact.<br>
    :type url: django.db.models.TextField<br>
<br>
    Relations:<br>
<br>
    :cvar artifact: The artifact that is expected to be present at ``url``.<br>
    :type artifact: pulp.app.models.Artifact<br>
    :cvar importer: The importer that contains the configuration necessary<br>
                    to access ``url``.<br>
    :type importer: pulp.app.models.Importer<br>
<br>
    """<br>
<br>
...is easier to read than this?<br>
<br>
    """<br>
    Fields:<br>
<br>
        url (models.TextField): The URL used to download the related artifact.<br>
<br>
    Relations:<br>
<br>
        artifact (Artifact): The artifact that is expected to be present at ``url``.<br>
        importer (Importer): The importer that contains the<br>
            configuration necessary to access ``url``.<br>
<br>
    """"<br>
<br>
</blockquote></div><br></div>