Python evolution: Unease

[Batista, Facundo]

[Daniel Bowett]

#- Contribute to where on Sourceforge??? Which domentation are 
#- we talking 
#- about in general?

Suppose you're reading Python documentation. Don't know, for example,
os.remove(). There you find that a particular parragraph is difficult to
understand. You say "Hey, this could be better written", so you write i a
more pedagogic way.

After that you go to SF, Python project
(http://sourceforge.net/projects/python), and go to Bugs. There, if you are
logged in SF, you will see a "Submit new" link. You click on it and you'll
see a form to fill.

Select some fields (specially bug group in "Documentation") and in "Detailed
Description:" you put something like "This particular sentence was difficult
to read. Attaching a new way to write it". Of course, then attach the file
of your text (if it's short enough you can put it directly in that field).

Of course, if you write any NEW documentation about something that is not
documented at all, or find some more serious issues with the docs (for
example, bad argument count in a function) you can follow the same steps.

.    Facundo

Bitácora De Vuelo: http://www.taniquetil.com.ar/plog
PyAr - Python Argentina: http://pyar.decode.com.ar/


  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
ADVERTENCIA.

La información contenida en este mensaje y cualquier archivo anexo al mismo,
son para uso exclusivo del destinatario y pueden contener información
confidencial o propietaria, cuya divulgación es sancionada por la ley.
Si Ud. No es uno de los destinatarios consignados o la persona responsable
de hacer llegar este mensaje a los destinatarios consignados, no está
autorizado a divulgar, copiar, distribuir o retener información (o parte de
ella) contenida en este mensaje. Por favor notifíquenos respondiendo al
remitente, borre el mensaje original y borre las copias (impresas o grabadas
en cualquier medio magnético) que pueda haber realizado del mismo.
Todas las opiniones contenidas en este mail son propias del autor del
mensaje y no necesariamente coinciden con las de Telefónica Comunicaciones
Personales S.A. o alguna empresa asociada.
Los mensajes electrónicos pueden ser alterados, motivo por el cual
Telefónica Comunicaciones Personales S.A. no aceptará ninguna obligación
cualquiera sea el resultante de este mensaje.
Muchas Gracias.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/python-list/attachments/20050105/e194a6b4/attachment.html>