[Python-Dev] Python Doc problems

Steve Holden steve at holdenweb.com
Fri Sep 29 03:41:01 CEST 2006


stephen at xemacs.org wrote:
> xah lee writes:
> 
>  > anyway, i've rewrote the Python's RE module documentation, at:
>  >   http://xahlee.org/perl-python/python_re-write/lib/module-re.html
> 
> -1
> 
> The current docs could be improved (but not by me, at least not
> today), but I don't consider the general direction of Xah's edits
> desirable.  Eg, the current table of contents is just as accurate and
> more precise than Xah's top node, which makes navigation faster for
> someone who knows what he forgot.<wink>  In general his changes
> improve the "narrative flow", but for me that's a very low priority in
> a reference manual, while the cost in loss of navigability of his
> changes is pretty high for me.
> 
'Fraid that doesn't get him any nearer his hundred bucks, then. Xah: the 
money it still on offer should you choose to rewrite until the criteria 
are satisfied.

regards
  Steve
-- 
Steve Holden       +44 150 684 7255  +1 800 494 3119
Holden Web LLC/Ltd          http://www.holdenweb.com
Skype: holdenweb       http://holdenweb.blogspot.com
Recent Ramblings     http://del.icio.us/steve.holden



More information about the Python-Dev mailing list