No tienes acceso a esta clase

隆Contin煤a aprendiendo! 脷nete y comienza a potenciar tu carrera

Reglas para la nomenclatura

5/24
Recursos

Aportes 10

Preguntas 7

Ordenar por:

驴Quieres ver m谩s aportes, preguntas y respuestas de la comunidad?

Reglas de nomenclatura.

驴C贸mo nombro correctamente mis variables, funciones, etc鈥?

  1. Nombres pronunciables y expresivos. Preferentemente en ingl茅s usando camelCase馃惈, evitando guiones - o _ y abreviaturas.
  2. Nombres sin informaci贸n t茅cnica. Evitar nombres con relaci贸n a la tecnolog铆a (tipo de datos, clases, etc). Ej. 鈥渁rrayNames鈥 --> 鈥渘amesList鈥
  3. Usar lenguaje ubicuo (ubique茅???): aquel que se construye a partir del lenguaje que usan los expertos, es decir: crear un lenguaje en com煤n para desarrolladores e interesados, determinando palabras de uso com煤n.

El lenguaje ubicuo, tambi茅n conocido como lenguaje universal, es un concepto desarrollado por el experto en tecnolog铆a de la informaci贸n y autor Martin Fowler, que se refiere a un lenguaje com煤n y compartido entre todos los miembros de un equipo o empresa, independientemente de sus antecedentes, roles o 谩reas de experiencia.

El objetivo del lenguaje ubicuo es mejorar la comunicaci贸n y la colaboraci贸n en un equipo, especialmente en proyectos complejos en los que participan varias partes interesadas. Al establecer un conjunto com煤n de t茅rminos y definiciones, se pueden evitar malentendidos, errores y retrasos, lo que puede mejorar la eficiencia y la calidad del trabajo.

El lenguaje ubicuo se basa en la idea de que las personas utilizan el lenguaje para modelar su comprensi贸n de un dominio. Al establecer un lenguaje compartido, se puede mejorar la comprensi贸n de un proyecto o sistema, lo que puede conducir a una mejor toma de decisiones y mejores resultados.

El ejemplo sobre el lenguaje ubicuo tiene bastante que ver con el desarrollo de software debido a que cuando creamos una base de datos tenemos que definir las entidades y esas entidades pueden ser el ejemplo de clientes usuarios etc. todo lo podemos juntar en usuarios y despu茅s partir en dimensiones de direcciones, ubicaciones, billeteras, contacto, etc. entonces esto no solamente afecta la legibilidad del c贸digo tambi茅n afecta la estructura de la base de datos la mantenibilidad de la misma y adem谩s de que respeta el principio DRY debido a que el c贸digo que tendr铆amos que escribir para llamar la Data de los diferentes nombres que se le da al usuario es b谩sicamente el mismo y se repite tres veces.

Reglas para la nomenclatura

鉃 Para contribuir a que nuestro c贸digo sea limpio hay que nombrar correctamente a nuestras variables funciones y clases, las variables funciones, etc deben ser expresivas, es decir en ingles y camel case, evitar el uso de guiones, guiones bajos y abreviaturas.

// no recomendado
const yyyymmdstr = moment().format("YYYY/MM/DD");

// no recomendado
const currentDate = moment().format("YYYY/MM/DD");

鉃 Nombres sin informaci贸n t茅cnica , evitar usar nombre relacionados a la tecnolog铆a, tipo de dato o clase.

// No recomendado
let arrayNames = ["Alex", " Mariana", "Cande"];
//recomendado
let namesList = ["Alex", " Mariana", "Cande"];

鉃 Usar lenguaje ubicuo, ques es? aquel que se construye a partir del lenguaje que usan los expertos en el dominio, un lenguaje en com煤n entre los devs y los interesados

// no recomendado
getUserInfo();
getClientData();
getCustomerRecord();

// recomendado
getUser();

tanto user, client and customer se pueden agrupar en user, si representan el mismo concepto. (representar a un usuario)

Recuerden siempre utilizar PascalCase para nombrar clases. Esto tambi茅n aplica para nombrar alias types e interfaces en TypeScript

Lenguaje ubicuo, es un t茅rmino usado en el desarrollo, para entenderlo m谩s f谩cil, imagina que es la jerga que tienes en tu grupo de amigos cu谩ndo es un proyecto en un equipo. Ejemplo: Decir 鈥楽e est谩 ofreciendo鈥 y que todos entiendan que 鈥楨star铆a bien hacer esto鈥.

Y es como la jerga de una regi贸n cu谩ndo es de un lenguaje, como en este caso (Javascript).
Ejemplo:
En Espa帽a dices 'Lo est谩 petando鈥
En M茅xico dices 鈥楲a est谩 rompiendo鈥

En ambos casos te podr谩n entender que 鈥楲e est谩 yendo muy bien鈥, pero para evitar confusi贸n y sonar raro, a d贸nde vas, haces lo que ves.
Como en Javascript dices getUser() y en Python dices get_user()

```js //REGLA 1 => Nombres pronunciables y expresivos usando camelCase //No recomendado const yyyymmdstr = moment.format("YYYY/MM/DD"); //Recomendado const currentDate = moment.format("YYYY/MM/DD"); //REGLA 2 => Nombres sin informaci贸n tecnica (tipo de dato, tipo de clases, etc) //No recomendado let arrayNames = ["Juan", "Pedro", "Maria"]; //Recomendad let namesList = ["Juan", "Pedro", "Maria"]; //REGLA 3 => Usar lenguaje ubicuo,crear un lenguaje en com煤n para desarrolladores e //interesados, determinando palabras de uso com煤n. //No recomendado getUserId(); getClientData(); getCustomerRecord(); //Recomendado getUser(); ```*//REGLA 1 => Nombres pronunciables y expresivos usando camelCase//No recomendado*const yyyymmdstr = moment.format("YYYY/MM/DD");*//Recomendado*const currentDate = moment.format("YYYY/MM/DD"); *//REGLA 2 => Nombres sin informaci贸n tecnica (tipo de dato, tipo de clases, etc)//No recomendado*let arrayNames = \["Juan", "Pedro", "Maria"];*//Recomendad*let namesList = \["Juan", "Pedro", "Maria"]; *//REGLA 3 => Usar lenguaje ubicuo,crear un lenguaje en com煤n para desarrolladores e //interesados, determinando palabras de uso com煤n.//No recomendado*getUserId();getClientData();getCustomerRecord();*//Recomendado*getUser();
Consulta. En la clase anterior la profesora dijo que recomienda declarar las **contantes** con **may煤sculas**, pero ahora nos dice que usemos **camelCase** 驴Cu谩l deber铆amos usar? Tengo entendido que por practicidad y mejor lectura del c贸digo tendr铆amos que utilizar **may煤sculas** para las **contantes**. Gracias. :D

NOMENCLATURA

Nombres pronunciables y expresivos: en ingl茅s, usando camelCase, evitando guiones 鈥-鈥, 鈥淿鈥 y abreviaturas.

Nombres sin info t茅cnica: tipo de datos, clases,etc.

Usar lenguaje ubicuo: lenguaje en com煤n entre devs y stakeholders.

Nombres descriptivos de lo que hace/usa la variable/funcion