Re: PyWart: Poor Documentation Examples

2015-01-11 Thread alex23
On 11/01/2015 7:31 PM, Steven D'Aprano wrote: If that isn't a form of stupidity, I don't know what is. Maybe you're just eternally optimistic that people can change for the better. -- https://mail.python.org/mailman/listinfo/python-list

Re: PyWart: Poor Documentation Examples

2015-01-11 Thread Mark Lawrence
On 11/01/2015 16:04, Grant Edwards wrote: On 2015-01-10, Chris Angelico wrote: On Sun, Jan 11, 2015 at 5:05 AM, Rick Johnson wrote: EXAMPLE 1: "Reducing Comprehension" https://docs.python.org/2/howto/doanddont.html#using-the-batter

Re: PyWart: Poor Documentation Examples

2015-01-11 Thread Rustom Mody
On Sunday, January 11, 2015 at 10:49:11 PM UTC+5:30, Chris Angelico wrote: > On Mon, Jan 12, 2015 at 4:11 AM, Michael Torrie wrote: > > The last post by RR helping someone with a tk problem was very helpful, > > and rather elucidating, as are most of his post on tk. ... > > Now perhaps there are

Re: PyWart: Poor Documentation Examples

2015-01-11 Thread Chris Angelico
On Mon, Jan 12, 2015 at 4:11 AM, Michael Torrie wrote: > The last post by RR helping someone with a tk problem was very helpful, > and rather elucidating, as are most of his post on tk. ... > Now perhaps there are two RRs, in some sort of conflict in > the same person. Sad to see this one winnin

Re: PyWart: Poor Documentation Examples

2015-01-11 Thread Michael Torrie
On 01/11/2015 09:04 AM, Grant Edwards wrote: > 3) There are still people who read RR posts? The last post by RR helping someone with a tk problem was very helpful, and rather elucidating, as are most of his post on tk. It was rather refreshing to see several posts like this. I thought perhaps th

Re: PyWart: Poor Documentation Examples

2015-01-11 Thread Chris Angelico
On Mon, Jan 12, 2015 at 3:04 AM, Grant Edwards wrote: > On 2015-01-10, Chris Angelico wrote: >> 1) Why are you focusing on the /2/ docs, rather than /3/? >> 2) Why are you ranting, rather than submitting docs patches? > > 3) There are still people who read RR posts? Yeah, there are. Steven summa

Re: PyWart: Poor Documentation Examples

2015-01-11 Thread Grant Edwards
On 2015-01-10, Chris Angelico wrote: > On Sun, Jan 11, 2015 at 5:05 AM, Rick Johnson > wrote: >> >> EXAMPLE 1: "Reducing Comprehension" >> https://docs.python.org/2/howto/doanddont.html#using-the-batteries >> ===

Re: PyWart: Poor Documentation Examples

2015-01-11 Thread Dan Sommers
On Sun, 11 Jan 2015 06:20:34 -0800, Rustom Mody wrote: > A favorite example of mine is automata-acceptance: > If > δ : Q × Σ → Q is a transition function > F is the set of final states > q₀ is the start state > and s is a string > > then > reduce(δ,q₀,s) ∈ F > expresses "automaton accepts strin

Re: PyWart: Poor Documentation Examples

2015-01-11 Thread Rustom Mody
On Sunday, January 11, 2015 at 10:56:11 AM UTC+5:30, Devin Jeanpierre wrote: > On Sat, Jan 10, 2015 at 6:32 PM, Steven D'Aprano wrote: > > At the point you are demonstrating reduce(), if the reader doesn't > > understand or can't guess the meaning of "n = 4", "n+1" or range(), they > > won't unders

Re: PyWart: Poor Documentation Examples

2015-01-11 Thread Steven D'Aprano
Ethan Furman wrote: > On 01/10/2015 06:32 PM, Steven D'Aprano wrote: >> >> If you treat your readers as idiots, only idiots will read your writing. > > Or the morbidly curious, which I presume covers your case (along with a > handful of others ;) . Reading Rick is like taking bad drugs. Every

Re: PyWart: Poor Documentation Examples

2015-01-10 Thread Ethan Furman
On 01/10/2015 06:32 PM, Steven D'Aprano wrote: > > If you treat your readers as idiots, only idiots will read your writing. Or the morbidly curious, which I presume covers your case (along with a handful of others ;) . -- ~Ethan~ signature.asc Description: OpenPGP digital signature -- https

Re: PyWart: Poor Documentation Examples

2015-01-10 Thread Devin Jeanpierre
On Sat, Jan 10, 2015 at 6:32 PM, Steven D'Aprano wrote: > At the point you are demonstrating reduce(), if the reader doesn't > understand or can't guess the meaning of "n = 4", "n+1" or range(), they > won't understand anything you say. > > Teachers need to understand that education is a process o

Re: PyWart: Poor Documentation Examples

2015-01-10 Thread Rustom Mody
On Sunday, January 11, 2015 at 8:02:50 AM UTC+5:30, Steven D'Aprano wrote: > Rick Johnson wrote: > > > > > > EXAMPLE 1: "Reducing Comprehension" > > https://docs.python.org/2/howto/doanddont.html#using-the-batteries > >

Re: PyWart: Poor Documentation Examples

2015-01-10 Thread Steven D'Aprano
Rick Johnson wrote: > > EXAMPLE 1: "Reducing Comprehension" > https://docs.python.org/2/howto/doanddont.html#using-the-batteries > > > >

Re: PyWart: Poor Documentation Examples

2015-01-10 Thread Mark Lawrence
On 10/01/2015 18:26, Chris Angelico wrote: On Sun, Jan 11, 2015 at 5:05 AM, Rick Johnson wrote: EXAMPLE 1: "Reducing Comprehension" https://docs.python.org/2/howto/doanddont.html#using-the-batteries ==

Re: PyWart: Poor Documentation Examples

2015-01-10 Thread Chris Angelico
On Sun, Jan 11, 2015 at 5:05 AM, Rick Johnson wrote: > > EXAMPLE 1: "Reducing Comprehension" > https://docs.python.org/2/howto/doanddont.html#using-the-batteries > 1) Why are