Geek & Freak!

Normas de Codificación y Convenciones de Nomenclatura. Continuamos con más consejos, ahora toca mencionar el tema de las normas  de codificación y convenciones de nomenclaturas para tener establecidos en un proyecto, ya que es importante que todo el proyecto se encuentre bien estructurado y todo bajo unas normas establecidas desde un inicio. Esto ayudara para que nuevos programadores cuando entren a un proyecto avanzado les sea más fácil encontrar métodos, conocer los parámetros y sobre todo la nomenclatura dentro del proyecto, sin mencionar que facilitara la documentación. .Net Usar la convención de PascalCasing inclusive en acrónimos como Html. Utilizarlo en todos los miembros públicos, tipos y nombres de namespace que contengan varias palabras. Usar camelCase para variables locales y argumentos de métodos, es decir que siempre la primera letra será minúscula. public class UserLog { public void Add(LogEvent logEvent) { int itemCount = l...

En esta ocasión les compartiré un par de consejos para buenas practicas al momento de la codificación en ASP.Net C#, son sencillas y  muy básicas pero sin lugar a dudas serán de mucha ayuda para documentar y entender mejor el código y claro se vera mucho más limpia tu programación.   Uso de Regiones   Las regiones (#region) agrupan código, permitiendo colapsar o doblar la sección para mejorar la legibilidad y navegación de una clase. Solo podrán ponerse a nivel de clase, nunca dentro de un método. Una clase deberá tener las siguientes regiones: Propiedades Constructores Variables globales Delegados Manejadores de Eventos Operaciones Publicas Operaciones Privadas LinQ y Métodos encadenados   Los métodos encadenados, comunes en LinQ, tienden a ser muy largos en una sola línea de código. Si se tiene este caso, deben romperse en múltiples líneas, comenzando siempre por el punto y el nombre de la operación: resultado =...

¿Que es OpenAPI? Como todos sabemos una API (Application Programming Interface) es un gran conjunto de procedimientos y protocolos con el fin de poder ser utilizados en diversos Software para que se comuniquen con otros Software. La finalidad del OpenAPI es generar una estructura genérica para el apoyo de la documentación de un servicio REST, sin importar sobre que lenguaje o tecnología  se allá implementado. Los principales puntos que este llevaría son: Descripción de un servicio.  Detallar las capacidades de una API.  Conocer los detalles del funcionamiento de una API. Lo cual todo esto nos permite: Generar páginas de documentación automáticamente. Herramientas de diseño y modelado de servicios. Generar automáticamente código de testing y de validaciones. Generar código cliente y de servicio, framework y lenguajes programación. En resumen OpenAPI nos permite definir y comprender las capacidades de un servicio o una API sin la necesidad de acc...