Re: Python's doc problems: sort
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 And WTF does Python documentation have to do with Perl of Lisp? szr, do you still have any doubts about the nature of xahlee? I wasn't involved in this thread, but no, after that statement comparing Perl's and Python's docs, I no doubts. * should have been, , I have no doubts. -- szr -- http://mail.python.org/mailman/listinfo/python-list
Re: Python's doc problems: sort
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 intercommunication, I faked most of the user agent strings but still was locked out by popular pages. I then figured it would be much better to fetch a useless page a couple of times. Sorry for the lognoise... /martin -- http://www.xing.com/profile/Martin_Marcher You are not free to read this message, by doing so, you have violated my licence and are required to urinate publicly. Thank you. -- http://mail.python.org/mailman/listinfo/python-list
Re: Python's doc problems: sort
[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 that this claim says more about its author than it does about its subject. Welcome to my killfile. -- http://mail.python.org/mailman/listinfo/python-list
Re: Python's doc problems: sort
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 to do with Perl of Lisp? szr, do you still have any doubts about the nature of xahlee? Welcome to my killfile. Done a long, long time ago. Follow-up set. jue -- http://mail.python.org/mailman/listinfo/python-list
Re: Python's doc problems: sort
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 Python documentation have to do with Perl of Lisp? szr, do you still have any doubts about the nature of xahlee? I wasn't involved in this thread, but no, after that statement comparing Perl's and Python's docs, I no doubts. -- szr -- http://mail.python.org/mailman/listinfo/python-list
Re: Python's doc problems: sort
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 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 authors. Nothing is stopping you from making doc changes and submitting them for review now, unless grandstanding is your actual intent. -- http://mail.python.org/mailman/listinfo/python-list
Re: Python's doc problems: sort
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 authors.» Dear Alex moron number 23, The art of writing takes many forms. Let's take, the hallowed name Shakespeare. Imagine, we injest his writing style into modern journalism. What is the resulting quality? It would be condemned as the worst journalism possible. Imprecise, logorrhea, obscure, and in general, much ado about nothing. On the other hand, if we apply the spirit of scientific report into poetry, what is the resulting quality? Dry, inert, dead. A man without a cock, a woman without tits. You see, i had to craft my style to fit occasions. In dealing with newsgroup morons like yourself, the proper style is to infuse insult with fanfare. Further readings: The Tragedy Of Titus Andronicus http://xahlee.org/p/titus/titus.html Politics and the English Language http://xahlee.org/p/george_orwell_english.html English Lawers (or, how to master writing) http://xahlee.org/UnixResource_dir/writ/english_lawers.html Xah [EMAIL PROTECTED] ∑ http://xahlee.org/ ☄ -- http://mail.python.org/mailman/listinfo/python-list
Re: Python's doc problems: sort
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 accusations of elitism aimed at the module authors.» Dear Alex moron number 23, Thank you for illustrating my point perfectly. -- http://mail.python.org/mailman/listinfo/python-list
Re: Python's doc problems: sort
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 other prestigious journals, or tech writers at Apple or Microsoft or Google.) Please contact me if interested. (Otherwise, perhaps someone at google can alot his extra project to rewrite the python doc. 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) Xah [EMAIL PROTECTED] ∑ http://xahlee.org/ ☄ -- http://mail.python.org/mailman/listinfo/python-list
Re: Python's doc problems: sort
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 about the Python documentation is no help to anyone if one is not willing to improve it. regards, Marek -- http://mail.python.org/mailman/listinfo/python-list
Re: Python's doc problems: sort
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 ! | '--Ooo--' |__|__| || || ooO Ooo Doesn't copying Rainer Joswig's troll warning constitute a copywright infrigment :) It's not an exact copy of Rainer's so it may be arguable whether it violates his copyright. Might have more luck with a trademark argument - distorted marks may still infringe. George -- for email reply remove / from address -- http://mail.python.org/mailman/listinfo/python-list
Re: Python's doc problems: sort
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 you bother polluting this NG? Back into the killfile you go jue \|||/ (o o) ,ooO--(_)---. | Please| | don't feed the | | TROLL's ! | '--Ooo--' |__|__| || || ooO Ooo Doesn't copying Rainer Joswig's troll warning constitute a copywright infrigment :) -- John Thingstad -- http://mail.python.org/mailman/listinfo/python-list
Re: Python's doc problems: sort
[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
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 \|||/ (o o) ,ooO--(_)---. | Please| | don't feed the | | TROLL's ! | '--Ooo--' |__|__| || || ooO Ooo -- http://mail.python.org/mailman/listinfo/python-list