[Python-Dev] The docs, reloaded (original) (raw)

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