Re: [Edu-sig] Edu-sig Digest, Vol 142, Issue 6

2015-05-15 Thread Marianne McKenna
I am away from the office - returning on Monday- May 18th. I will try to respond by email. If you need immediate help, please contact tech support. Thanks! ___ Edu-sig mailing list Edu-sig@python.org https://mail.python.org/mailman/listinfo/edu-sig

Re: [Edu-sig] Pythonic Notes: comments versus docstrings, other topics

2015-05-15 Thread Kirby Urner
The help on __doc__ belongs in the same section as help on __name__ and even __file__ as these are likewise attributes at the module level, which is where our course series first mentions docstrings (Lesson 1, Project 1 is already docstring aware). [1] Footnotes [1] these on-line courses

[Edu-sig] Pythonic Notes: comments versus docstrings, other topics

2015-05-15 Thread Kirby Urner
*TEACHER TO TEACHER: PYTHONIC NOTES* *1. Docstrings Versus Comments* In teaching Python quite a bit, I find even pro programmers get confused about docstrings, as many languages have nothing quite like them. Your audience is not readers of your source code, which they may not have, but users