Re: Python's doc problems: sort

2008-06-02 Thread szr
szr wrote: Jürgen Exner wrote: Andrew Koenig [EMAIL PROTECTED] wrote: [EMAIL PROTECTED] wrote in message [Subject: Python's doc problems: sort] I want to emphasize a point here, as i have done quite emphatically in the past. The Python documentation, is the world's worst technical

Re: Python's doc problems: sort

2008-06-02 Thread Martin Marcher
Hi, On Wed, Apr 30, 2008 at 4:48 AM, [EMAIL PROTECTED] [EMAIL PROTECTED] wrote: For example, in last week, that page is fetched 550 times. The second most popular page, trails quite a distance. Here's the top yup that was me, i have access to a couple of machines and wanted to test some

Re: Python's doc problems: sort

2008-06-01 Thread Andrew Koenig
[EMAIL PROTECTED] wrote in message news:[EMAIL PROTECTED] I want to emphasize a point here, as i have done quite emphatically in the past. The Python documentation, is the world's worst technical writing. As far as technical writing goes, it is even worse than Perl's in my opinion. I think

Re: Python's doc problems: sort

2008-06-01 Thread J�rgen Exner
Andrew Koenig [EMAIL PROTECTED] wrote: [EMAIL PROTECTED] wrote in message [Subject: Python's doc problems: sort] I want to emphasize a point here, as i have done quite emphatically in the past. The Python documentation, is the world's worst technical And WTF does Python documentation have

Re: Python's doc problems: sort

2008-06-01 Thread szr
Jürgen Exner wrote: Andrew Koenig [EMAIL PROTECTED] wrote: [EMAIL PROTECTED] wrote in message [Subject: Python's doc problems: sort] I want to emphasize a point here, as i have done quite emphatically in the past. The Python documentation, is the world's worst technical And WTF does

Re: Python's doc problems: sort

2008-05-21 Thread alex23
On May 21, 8:53 am, Xah Lee [EMAIL PROTECTED] wrote: The complaint about python doc has turned up now and then in the past few years it seems, but always got put down by python priests No, what was generally rejected was the idea that *you* could bring more clarity to the documentation, based

Re: Python's doc problems: sort

2008-05-21 Thread Xah
alex23 wrote: «No, what was generally rejected was the idea that *you* could bring more clarity to the documentation, based on the complete absence of it in your posts essays. Basically, noone wanted docs that would randomly degenerate into ad hominem accusations of elitism aimed at the module

Re: Python's doc problems: sort

2008-05-21 Thread alex23
On May 22, 2:28 am, Xah [EMAIL PROTECTED] wrote: «No, what was generally rejected was the idea that *you* could bring more clarity to the documentation, based on the complete absence of it in your posts essays. Basically, noone wanted docs that would randomly degenerate into ad hominem

Re: Python's doc problems: sort

2008-05-20 Thread Xah Lee
I offer the python community complete rewrite of the Python doc. The resulting doc would be one of the best technical writing among Open Source community's documentations. (a fair verification can be obtained by polling professional writers and editor community, e.g. staff writers of Time Mag or

Re: Python's doc problems: sort

2008-05-12 Thread Marek Kubica
On Tue, 29 Apr 2008 19:48:39 -0700, [EMAIL PROTECTED] wrote: Python priests: go fuck yourselfs. In case you have something useful to add, grap the documentation sources of Python 2.6 (they were converted from LaTeX to reST now) and send a patch to the documentation maintainers. Lamenting

Re: Python's doc problems: sort

2008-05-02 Thread George Neuner
On Wed, 30 Apr 2008 12:35:10 +0200, John Thingstad [EMAIL PROTECTED] wrote: På Wed, 30 Apr 2008 06:26:31 +0200, skrev George Sakkis [EMAIL PROTECTED]: \|||/ (o o) ,ooO--(_)---. | Please| | don't feed the | | TROLL's ! |

Re: Python's doc problems: sort

2008-04-30 Thread John Thingstad
På Wed, 30 Apr 2008 06:26:31 +0200, skrev George Sakkis [EMAIL PROTECTED]: On Apr 29, 11:13 pm, Jürgen Exner [EMAIL PROTECTED] wrote: [EMAIL PROTECTED] [EMAIL PROTECTED] wrote: Is this self-promoting maniac still going at it? Although i disliked Perl very much [...] Then why on earth do

Re: Python's doc problems: sort

2008-04-29 Thread J�rgen Exner
[EMAIL PROTECTED] [EMAIL PROTECTED] wrote: Is this self-promoting maniac still going at it? Although i disliked Perl very much [...] Then why on earth do you bother polluting this NG? Back into the killfile you go jue -- http://mail.python.org/mailman/listinfo/python-list

Re: Python's doc problems: sort

2008-04-29 Thread George Sakkis
On Apr 29, 11:13 pm, Jürgen Exner [EMAIL PROTECTED] wrote: [EMAIL PROTECTED] [EMAIL PROTECTED] wrote: Is this self-promoting maniac still going at it? Although i disliked Perl very much [...] Then why on earth do you bother polluting this NG? Back into the killfile you go jue