Re: [Python-Dev] New Pythondoc by effbot

2006-01-22 Thread Tony Meyer
For me, the -nospam suffix works relatively good to avoid spam, as most harvesting programs will think this is a false address. http://spambayes.org works, too, without bothering others 0.5 wink =Tony.Meyer ___ Python-Dev mailing list

Re: [Python-Dev] New Pythondoc by effbot

2006-01-22 Thread Georg Brandl
Guido van Rossum wrote: On 1/21/06, Georg Brandl [EMAIL PROTECTED] wrote: What Fredrik hacks together there (http://www.effbot.org/lib) is very impressive. I especially like the permalinks in this style: http://effbot.org/lib/os.path.join Which (despite having perma in its name) evaporates

Re: [Python-Dev] New Pythondoc by effbot

2006-01-22 Thread Walter Dörwald
Georg Brandl wrote: [...] Can you mock that up a bit? I'm somewhat confused about what you're requesting, and also worried that it would take up too much horizontal space. (Despite that monitors are wider than tall, horizontal real estate feels more scarce than vertical, because

Re: [Python-Dev] New Pythondoc by effbot

2006-01-22 Thread Georg Brandl
Walter Dörwald wrote: Georg Brandl wrote: [...] Can you mock that up a bit? I'm somewhat confused about what you're requesting, and also worried that it would take up too much horizontal space. (Despite that monitors are wider than tall, horizontal real estate feels more scarce than

Re: [Python-Dev] New Pythondoc by effbot

2006-01-22 Thread Fredrik Lundh
Guido wrote: What Fredrik hacks together there (http://www.effbot.org/lib) is very impressive. I especially like the permalinks in this style: http://effbot.org/lib/os.path.join Which (despite having perma in its name) evaporates and leaves behind a link to os.path.html#join.

Re: [Python-Dev] New Pythondoc by effbot

2006-01-22 Thread Fredrik Lundh
Georg Brandl wrote: Vertical spacing is IMHO pretty bad on this page. Everything has the same distance from everything else. This makes under- standing the structure of the page pretty hard. The main content is the original zipfile.html from http://www.effbot.org/lib/zipfile.html. Only

Re: [Python-Dev] New Pythondoc by effbot

2006-01-22 Thread Fredrik Lundh
(this is the main motivator behind my documentation and site efforts; we should learn not to press control-enter when we mean enter. anyway, what I intended to say was that we should work harder on lowering the threshold for drive-by contributions; it should be possible for anyone to notice a

Re: [Python-Dev] New Pythondoc by effbot

2006-01-22 Thread Fredrik Lundh
Guido van Rossum wrote: On this page, 8 of 30 entries have a 'new in' comment. For anyone with no interest in the past, these constitute noise. I wonder if for 3.0, the timer can be reset and the docs start clean again. To keep them backwards compatible, they would also have to be

Re: [Python-Dev] New Pythondoc by effbot

2006-01-22 Thread Nick Coghlan
Fredrik Lundh wrote: (this is the main motivator behind my documentation and site efforts; we should learn not to press control-enter when we mean enter. anyway, what I intended to say was that we should work harder on lowering the threshold for drive-by contributions; it should be

Re: [Python-Dev] New Pythondoc by effbot

2006-01-22 Thread Guido van Rossum
On 1/21/06, Georg Brandl [EMAIL PROTECTED] wrote: And, of course, the new in 2.x could be formatted less space-consuming, perhaps to the right of the method name. No, that would give it too much attention. It's getting way too outstanding in effbot's sample, probably because he didn't

Re: [Python-Dev] New Pythondoc by effbot

2006-01-22 Thread Guido van Rossum
(This is a bulk reply to several messages in this thread from Georg and Fredrik.) [Georg] http://effbot.org/lib/os.path.join [Guido] Which (despite having perma in its name) evaporates and leaves behind a link to os.path.html#join. [Georg] There may be other uses (e.g. marking a certain

Re: [Python-Dev] New Pythondoc by effbot

2006-01-22 Thread Facundo Batista
2006/1/22, Georg Brandl [EMAIL PROTECTED]: Guido van Rossum wrote: ... Why? If wikipedia can do without moderation (for most pages) then why couldn't the Python docs? Well, why not... it's surely worth a try. Perhaps using a spam filter like most modern weblogs would suffice. I can

Re: [Python-Dev] New Pythondoc by effbot

2006-01-22 Thread Georg Brandl
Guido van Rossum wrote: Which (despite having perma in its name) evaporates and leaves behind a link to os.path.html#join. There may be other uses (e.g. marking a certain location in the docs with a permalink marker so that one can point the user to /lib/marker. Especially useful for the

Re: [Python-Dev] New Pythondoc by effbot

2006-01-22 Thread Tim Peters
[Aahz] Aside to Georg: your messages are all getting /dev/null'd because you use spam in your From: line. I get too much spam to change that, and I'll bet other people use that heuristic. Please change your From: line for this mailing list. [Georg Brandl] I don't quite understand that. Why

Re: [Python-Dev] New Pythondoc by effbot

2006-01-22 Thread Tim Parkin
Guido van Rossum wrote: I believe there's a CSS trick (most often used for images) that can makes the summary window float to the right so that below it the main text resumes the full breadth of the window. If you can pull that off I think this is a good addition! Something like this...

Re: [Python-Dev] New Pythondoc by effbot

2006-01-22 Thread Tim Parkin
Tim Parkin wrote: Guido van Rossum wrote: I believe there's a CSS trick (most often used for images) that can makes the summary window float to the right so that below it the main text resumes the full breadth of the window. If you can pull that off I think this is a good addition!

Re: [Python-Dev] New Pythondoc by effbot

2006-01-22 Thread Georg Brandl
Tim Parkin wrote: Tim Parkin wrote: Guido van Rossum wrote: I believe there's a CSS trick (most often used for images) that can makes the summary window float to the right so that below it the main text resumes the full breadth of the window. If you can pull that off I think this is a good

Re: [Python-Dev] New Pythondoc by effbot

2006-01-22 Thread Tim Parkin
Georg Brandl wrote: Tim Parkin wrote: Something like this... http://beta.python.org/download/releases/2.4.1/ That's an ordinary float, I presume? indeed it is. It would also be simple to add an 'alternate stylesheet' that can hide the left hand navigation. A small link could

Re: [Python-Dev] New Pythondoc by effbot

2006-01-22 Thread Brett Cannon
[Fredrik, later] if we move over to a web-oriented (wiki-ish) maintenance model, we probably have to accept that X will, sometimes, be a future release. This makes me worry that you're thinking of abandoning having separate docs per version. That would be a shame; I think the docs ought to