harrismh777 harrismh777 at charter.net
Mon Jun 6 20:00:11 EDT 2011

• Previous message (by thread): API design before implementation (was: Lambda question)
• Next message (by thread): Generator Frustration
• Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]

---

Steven D'Aprano wrote:
> For any non-trivial function, I usually start by writing the
> documentation (a docstring and doctests) first. How else do you know what
> the function is supposed to do if you don't have it documented?

Yes. In my early years I was no different than any other hacker in terms 
of documenting last if at all... but having flown around the sun a few 
more times I've realized that good clear doc 'before' the code actually 
helps me write good clean code. If I implement what I've documented then 
I'm less likely to miss something in the doc, and more likely to have 
fewer bugs... this has played itself out many times for me.



kind regards,
m harris

---

• Previous message (by thread): API design before implementation (was: Lambda question)
• Next message (by thread): Generator Frustration
• Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]

---

More information about the Python-list mailing list