Python evolution: Unease
Daniel Bowett
daniel at bowettsolutions.com
Wed Jan 5 15:18:42 EST 2005
Batista, Facundo wrote:
> [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.*
>
Thanks, typically how long does it take for any documentation to be
considered and implemented?
More information about the Python-list
mailing list