On Wed, Mar 10, 2010 at 09:45, John Posner <jjpos...@optimum.net> wrote: > [ cross-posting to edu-sig ] > > Bruno (and anyone else interested) -- > > As I promised/threatened, here's the *start* of a write-up on properties, > aimed at non-advanced Python programmers: > > http://www.jjposner.net/media/python-properties-0310.pdf > > I'm interested in corrections, of course. But I'm also interested in > opinions as to whether this somewhat lengthy treatment is worth the effort > -- does it improve on existing write-ups?
I find that it will explain things to those who already understand most of the concepts. However, I felt as though I were being led through a maze without knowing where we were headed. This suggests that the concepts can be re-ordered in a manner that will help your readers more, and then we can refactor further. (Yes, you can apply Extreme Programming concepts to create Extreme Documentation, including consultations with users, pair or group writing, frequent refactoring, and more, as at FLOSSManuals.net.) Who is your expected audience? > Tx, > John > > _______________________________________________ > Edu-sig mailing list > edu-...@python.org > http://mail.python.org/mailman/listinfo/edu-sig > -- Edward Mokurai (默雷/धर्ममेघशब्दगर्ज/دھرممیگھشبدگر ج) Cherlin Silent Thunder is my name, and Children are my nation. The Cosmos is my dwelling place, the Truth my destination. http://www.earthtreasury.org/ -- http://mail.python.org/mailman/listinfo/python-list
