<div dir="ltr"><div><div><div><div><div>I've really got to butt in here and say that y'all may have a mis-understanding of what Sphinx lets you do. I'm seeing code examples like this:<br><br>    :param repo_name: The name of the repo<br>
    :type  repo_name: basestring<br><br></div>And criticisms like this:<br><br>> I, personally, am not a big fan of the ":param foo:" syntax.  To me, it puts way to much information<br>> spread across multiple lines, increasing the length/scrolling/brainpower needed to parse such an<br>> item.  I have to read multiple lines just to figure out what type  a variable has.<br><br></div>But Sphinx also lets you document parameters like this:<br><br></div>    :param basestring repo_name: The name of the repo<br><br></div>So - definitely consider switching to Napoleon or whatever you like. That's cool. But please, fully understand what Sphinx offers.<br><br></div>-Jeremy<br></div>