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 time

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 understand

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 string s

Re: PyWart: Poor Documentation Examples

2015-01-11 Thread Chris Angelico
On Mon, Jan 12, 2015 at 3:04 AM, Grant Edwards invalid@invalid.invalid wrote: On 2015-01-10, Chris Angelico ros...@gmail.com 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

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

Re: PyWart: Poor Documentation Examples

2015-01-11 Thread Grant Edwards
On 2015-01-10, Chris Angelico ros...@gmail.com wrote: On Sun, Jan 11, 2015 at 5:05 AM, Rick Johnson rantingrickjohn...@gmail.com wrote: EXAMPLE 1: Reducing Comprehension

Re: PyWart: Poor Documentation Examples

2015-01-11 Thread Chris Angelico
On Mon, Jan 12, 2015 at 4:11 AM, Michael Torrie torr...@gmail.com 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

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 two

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 ros...@gmail.com wrote: On Sun, Jan 11, 2015 at 5:05 AM, Rick Johnson rantingrickjohn...@gmail.com wrote: EXAMPLE 1: Reducing Comprehension

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-10 Thread Chris Angelico
On Sun, Jan 11, 2015 at 5:05 AM, Rick Johnson rantingrickjohn...@gmail.com wrote: EXAMPLE 1: Reducing Comprehension https://docs.python.org/2/howto/doanddont.html#using-the-batteries

PyWart: Poor Documentation Examples

2015-01-10 Thread Rick Johnson
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 rantingrickjohn...@gmail.com 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 Devin Jeanpierre
On Sat, Jan 10, 2015 at 6:32 PM, Steven D'Aprano steve+comp.lang.pyt...@pearwood.info 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

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 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 --