Re: Method / Functions - What are the differences?

classic Classic list List threaded Threaded
2 messages Options
Reply | Threaded
Open this post in threaded view
|

Re: Method / Functions - What are the differences?

John Posner
[ 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?

Tx,
John

_______________________________________________
Edu-sig mailing list
[hidden email]
http://mail.python.org/mailman/listinfo/edu-sig
Reply | Threaded
Open this post in threaded view
|

Re: Method / Functions - What are the differences?

Mokurai
On Wed, Mar 10, 2010 at 09:45, John Posner <[hidden email]> 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
> [hidden email]
> 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/
_______________________________________________
Edu-sig mailing list
[hidden email]
http://mail.python.org/mailman/listinfo/edu-sig