Title: RE: Python evolution: Unease

[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.

-- 
http://mail.python.org/mailman/listinfo/python-list

Reply via email to