Foros Club Delphi

Foros Club Delphi (https://www.clubdelphi.com/foros/index.php)
-   Debates (https://www.clubdelphi.com/foros/forumdisplay.php?f=29)
-   -   Por que muchos dicen que se debe documentar el codigo em ingles? (https://www.clubdelphi.com/foros/showthread.php?t=95709)

JoAnCa 01-06-2022 05:28:34

Por que muchos dicen que se debe documentar el codigo em ingles?
 
Hola a todos
Pues me surge una inquietud con respecto al idioma en el que se debe documentar el codigo de una aplicacion, ya que uno de los integrantes del equipo de desarrollo dice que tiene que ser en ingles para cumplir con los estandares internacionales.


Mi criterio es que la convencion de nombres y las nomenclaturas a usar, aunque hay varias, se pueden usar cualquiera o incluso se pueden crear unas propias. No hay nada escrito que te obligue a usar una forma de nomenclatura en especifico.
Entonces ¿Por que usar el idioma ingles para nombrar las variables, clases, etc., asi como los campos de la base de datos?


Si al final el codigo fuente va dirigido al equipo de desarrollo, que hablan todos español, por que usar el ingles y no el español?


En que mejora el entendimiento del codigo o su funcionamiento, el usar el ingles?


Pudiera entenderse de usar el ingles para la interfaz de usuario, para que se pueda usar en cualquier pais, ya que el ingles es el idioma universal, pero actualmente lo que se recomienda es la internacionalizacion, que el usuario pueda seleccionar su idioma nativo para usar la aplicacion, es decir, que la aplicaion sea multilenguaje.


Entonces, no entiendo cual es el motivo por lo que todavia muchos insisten en que todo debe ser en ingles :confused:

dec 01-06-2022 08:37:26

Hola a todos,

Como dices, nadie puede obligar a nada, de modo que al final puede ser una decisión más a tomar hacerlo en español o en inglés. Lo que sí que acaso convendría es no mezclar, sino hacerlo siempre en uno de los dos idiomas. Pero hasta esto es sin duda otra decisión, pues tampoco es que se impida mezclar. Tal vez esto de "la mezcla" sea ya un punto a favor del inglés: al final, el nombre de funciones, procedimientos, clases, etc., serán en su mayoría en inglés, pues la VCL de Delphi, sin ir más lejos, utiliza ese idioma: al fin y al cabo todo esto "viene del inglés", vaya, lo inventaron ellos, de modo que, es normal que sea ese el idioma que se utilice: quienes lo inventaron no iban a usar un idioma que no dominasen.

Yo diría que aquí no se pueden dar sino opiniones, y, personalmente, prefiero el inglés a la hora de programar: y eso que no lo domino, ni mucho menos, y, cometo muchas faltas, pero, aún así, prefiero utilizar el inglés a la hora de programar. Pero esta es mi opinión y cada uno tendrá la cosa y no creo que esté nada escrito, en el sentido que he expresado más arriba: nada impide llamar a una variable "FMiComponente" o "FMyComponent", el compilador no va a quejarse en ninguno de los dos casos y la aplicación va a funcionar exactamente igual. De modo que como no hay "una sola forma", como ambos lenguajes (y aun otros) podrían usarse, al final es cuestión de acordar cuál usar, si ya es que no se decide que esto da lo mismo y que hasta se puedan mezclarse sin miramientos.

A lo mejor otros compañeros dan su opinión y hasta pueden basar esta en premisas que nos hagan reflexionar sobre este asunto a todos.

Neftali [Germán.Estévez] 01-06-2022 09:30:17

Cita:

Empezado por JoAnCa (Mensaje 547027)
Si al final el codigo fuente va dirigido al equipo de desarrollo, que hablan todos español, por que usar el ingles y no el español?
Pudiera entenderse de usar el ingles para la interfaz de usuario, para que se pueda usar en cualquier pais, ya que el ingles es el idioma universal, pero actualmente lo que se recomienda es la internacionalizacion, que el usuario pueda seleccionar su idioma nativo para usar la aplicacion, es decir, que la aplicaion sea multilenguaje.

Totalmente de acuerdo.
Él código es para el equipo de desarrollo y debería estar en Español (en nuestro caso).
Muchas veces, por lo que comenta [dec], creo que de tanto leer código de la VCL acabamos con la nomenclatura en inglés, pero eso debería especificarse dentro del equipo y estandarizarlo entre los desarrolladores.

Casimiro Notevi 01-06-2022 11:33:02

Los comentarios de los desarrolladores de un proyecto español y que hablan en español... en español, obviamente.
Si fuese un proyecto internacional o que se vaya a compartir en github/lab entonces estaría bien el inglés.
Los nombres de campos, variables, etc. eso ya a gusto de cada uno siguiendo unas normas comunes del grupo, pero eso ya no es cuestión de idiomas.


La franja horaria es GMT +2. Ahora son las 08:18:29.

Powered by vBulletin® Version 3.6.8
Copyright ©2000 - 2024, Jelsoft Enterprises Ltd.
Traducción al castellano por el equipo de moderadores del Club Delphi