[Python-Dev] The docs, reloaded

Steve Holden steve at holdenweb.com
Tue May 22 19:19:36 CEST 2007


Titus Brown wrote:
> On Tue, May 22, 2007 at 11:45:04AM -0500, skip at pobox.com wrote:
> -> 
> ->     >> You at least take away a common excuse for lack of contributions.
> ->     >> True whiners will just come up with new ones (e.g., "the
> ->     >> documentation isn't available in Sanskrit yet" or "the dog ate my
> ->     >> changes before I could type them into the computer"). ;-)
> -> 
> ->     Steve> But doesn't *everyone* now know that documentation contributions
> ->     Steve> don't have to be marked up? It's certainly been said
> ->     Steve> enough.
> -> 
> -> Sure, but that doesn't stop the true whiners. ;-)
> 
> Nothing stops the true whiners ;).
> 
> I think new and exciting ways of viewing, searching, annotating, linking
> to/from, and indexing the docs are more important than new formats for
> (not) writing the docs.
> 
> For example, this rocks! ::
> 
> 	http://pydoc.gbrandl.de/search.html?q=os.path&area=default
> 
It would be more impressive if the search string returned hits ...

regards
  Steve
-- 
Steve Holden        +1 571 484 6266   +1 800 494 3119
Holden Web LLC/Ltd           http://www.holdenweb.com
Skype: holdenweb      http://del.icio.us/steve.holden
------------------ Asciimercial ---------------------
Get on the web: Blog, lens and tag your way to fame!!
holdenweb.blogspot.com        squidoo.com/pythonology
tagged items:         del.icio.us/steve.holden/python
All these services currently offer free registration!
-------------- Thank You for Reading ----------------



More information about the Python-Dev mailing list