[python-win32] Request for comments

Ton van Vliet ton.vanvliet at skynet.be
Fri May 30 09:42:46 CEST 2008

On Thu, 22 May 2008 17:21:47 +0100, you wrote:

>I have a request of the python-win32 community. Have a look at:
>In particular, click through to the section on the Registry 
>(which is the only section which has anything useful in it!)
>and then tell me what you think. About anything. The contents,
>the style, the colours, the colors, the depth of examples, the
>notes. What should be there? What shouldn't? How much overlap
>there should be with other sources of documentation? How much
>should just be links across? Should I reproduce the pywin32 docs
>verbatim. (Difficult: I've got a branch which is trying. Very trying).
>Points to bear in mind:
>  * This is very alpha
>  * I'm using Sphinx but I've done very little with its capabilities
>  * The examples I've put together work: you can drop them straight 
>onto an interpreter window and run them. But is that a desirable goal.
>  * My intention is that this be a community effort. (The source is actually
>hosted at Google Code).
>  * This URL (probably) won't be its final resting place.
>In particular, it will be very clear as you read that I'm 100% sure where 
>I'm going with it yet. But at the very least I want lots of examples which, 
>even in passing, semi-document the kind of stuff which people ask about
>on python-win32 and python-list.
>Enough babble from me. Have a look.


IMHO the links could be a bit more visible.

When looking at the 'Where do I begin' paragraph, it took me quite some time to notice that there *were* actually links in there (after being taken there by clicking on the 'Where do I begin' link in the left hand column already several times)

Using Opera and FF on W2K at 1600x1200

Looking forward to using the contents.


More information about the python-win32 mailing list