Showing content from http://mail.python.org/pipermail/python-dev/attachments/20101109/a724f9cc/attachment.html below:
<div dir="ltr"><br><div class="gmail_quote">On Tue, Nov 9, 2010 at 04:07, R. David Murray <span dir="ltr"><<a href="mailto:rdmurray@bitdance.com">rdmurray@bitdance.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
<div class="im">On Mon, 08 Nov 2010 18:10:17 -0600, Ron Adam <<a href="mailto:rrr@ronadam.com">rrr@ronadam.com</a>> wrote:<br>
> def _private_api():<br>
> #<br>
> # Isn't it a good practice to use comments here?<br>
> #<br>
> ...<br>
<br>
</div>IMO, no.<br>
<br></blockquote></div><br>FWIW, I agree completely. Docstrings are a part of Python I don't see a reason to leave out for "non-public" code. They're convenient in the beginning of functions and we all are used to seeing them there. IDE's use them to display helpful "tooltips" on functions, and so on.<br>
<br><br>Eli<br><br></div>
RetroSearch is an open source project built by @garambo
| Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4