pforero / electopy

Simple tool in Python used to look and analyse General Election Results in Spain
GNU General Public License v3.0
1 stars 3 forks source link

Language/Lenguaje #7

Open pforero opened 5 years ago

pforero commented 5 years ago

Que lenguaje proponeis para el nombre de variables, wiki, Readme, etc...

Por ahora he usado ambos de manera mezclada, pero creo que deberia de haber una clara idea de cuando usamos una lengua u otra. Nuestro principal usuario obviamente va ha hablar español. Pero para mayor exposicion siempre ayuda el ingles.

Que opinais @gonmendoza @a-valvaq-2086 ?

Diferentes cosas pueden tener el diferentes lenguajes. Pero ha de ser consistente en esas cosas. Cosas como...

a-valvaq-2086 commented 5 years ago

Yo haría ambas versiones. Generalmente usuaría sólo el inglés para documentar y hacer el manual de uso. Pero ya que es un programita que va súper enfocado a las elecciones españolas. Dejaría el manual traducido. En cuanto al lenguaje del código y la documentación dentro del código. Sólo en inglés.

My2cents.

On Tue, 11 Jun 2019, 16:37 Pablo Forero, notifications@github.com wrote:

Que lenguaje proponeis para el nombre de variables, wiki, Readme, etc...

Por ahora he usado ambos de manera mezclada, pero creo que deberia de haber una clara idea de cuando usamos una lengua u otra. Nuestro principal usuario obviamente va ha hablar español. Pero para mayor exposicion siempre ayuda el ingles.

Que opinais @gonmendoza https://github.com/gonmendoza @a-valvaq-2086 https://github.com/a-valvaq-2086 ?

Diferentes cosas pueden tener el diferentes lenguajes. Pero ha de ser consistente en esas cosas. Cosas como...

  • Descripcion del Proyecto/Manual de Usuario
  • Nombres de las variables en codigo
  • Nombres de las Funciones/Clases/Metodos
  • Comentarios en Codigo
  • Errores de codigo/Texto visible al usuario

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/pforero/Electopy/issues/7?email_source=notifications&email_token=AMG2WDCBRJXWVH7UMMXUX6LPZ62DHA5CNFSM4HW7BDZ2YY3PNVWWK3TUL52HS4DFUVEXG43VMWVGG33NNVSW45C7NFSM4GY2UDSQ, or mute the thread https://github.com/notifications/unsubscribe-auth/AMG2WDCOGPBLENFBVSWWNGTPZ62DHANCNFSM4HW7BDZQ .

pforero commented 5 years ago

Entiendo la logica. Pero no se si es poco realista que pongamos el trabajo para tenerlo traducido. Soy yo al primero que no le gusta no hacer las cosas en ingles. Pero si solo pudiera uno de los dos leguajes, no se si español tendria mas sentida, por mucho que me duela.

El de codigo va a mas que solo las variables, si no las funciones. Por ejemplo si queremos ver los diputados, seria una funcion elecciones.diputados() Pero en ingles seria elections.mps()

Sobre todo porque al ser especifico de España, el lenguaje es muy concreto. "Circunscripcion", "Escaño", "Diputado", etc... Si lo ponemos en ingles habria que traducir esos terminos a vocabulario que no seria tan natural para el usuarion final

No se, mi codigo demuestra los conflictivo que es para mi, que el uso de ingles o español varia segun crea que es mejor en ese momento, pero no tiene ninguna vision global y consistente.

P.S. Una cosa que estoy haciendo es empezar a cargarme mayusculas, que peco mucho de ello.