Muestra las diferencias entre dos versiones de la página.
Ambos lados, revisión anterior Revisión previa Próxima revisión | Revisión previa | ||
ada:howto:sicoferp:factory:cleancode [2023/11/07 13:17] 192.168.175.10 |
ada:howto:sicoferp:factory:cleancode [2023/11/07 13:23] (actual) 192.168.175.10 |
||
---|---|---|---|
Línea 2: | Línea 2: | ||
Esta sección presenta las 7 reglas principales del Clean Code (Código Limpio). | Esta sección presenta las 7 reglas principales del Clean Code (Código Limpio). | ||
- | El concepto de código limpio se le atribuye a Robert Cecil Martin, un destacado ingeniero de software que popularizó este término en su libro "Clean Code: Refactoring, Patterns, Testing and Techniques for Clean Code". No obstante, los principios subyacentes a la idea de código limpio tienen raíces mucho más profundas y no se limitan exclusivamente al ámbito de la programación. A continuación, te ofrecemos una explicación sobre lo que implica el código limpio, sus beneficios y cómo llevarlo a la práctica((https://www.ionos.es/digitalguide/paginas-web/desarrollo-web/clean-code-que-es-el-codigo-limpio/)). | + | El concepto de código limpio se le atribuye a **Robert Cecil Martin**, un destacado ingeniero de software que popularizó este término en su libro "//**Clean Code: Refactoring, Patterns, Testing and Techniques for Clean Code**//". No obstante, los principios subyacentes a la idea de código limpio tienen raíces mucho más profundas y no se limitan exclusivamente al ámbito de la programación. A continuación, te ofrecemos una explicación sobre lo que implica el código limpio, sus beneficios y cómo llevarlo a la práctica((https://www.ionos.es/digitalguide/paginas-web/desarrollo-web/clean-code-que-es-el-codigo-limpio/)). |
===== ¿Que es Clean Code? ===== | ===== ¿Que es Clean Code? ===== | ||
Línea 36: | Línea 36: | ||
* Y, si es posible, aún más pequeñas. | * Y, si es posible, aún más pequeñas. | ||
- | Es importante no confundir "nombre" con "función". Como se mencionó en el primer principio, los nombres largos no son un problema, pero las funciones deben mantenerse breves. | + | Es importante no confundir "**nombre**" con "**función**". Como se mencionó en el primer principio, los nombres largos no son un problema, pero las funciones deben mantenerse breves. |
==== 4. DRY (No te repitas) ==== | ==== 4. DRY (No te repitas) ==== | ||
- | Este principio, acuñado en el libro "The Pragmatic Programmer," se aplica a diversas áreas de desarrollo, como: | + | Este principio, acuñado en el libro "//**The Pragmatic Programmer**//," se aplica a diversas áreas de desarrollo, como: |
* Bases de datos | * Bases de datos | ||
Línea 46: | Línea 46: | ||
* Codificación | * Codificación | ||
- | DRY defiende que cada elemento del conocimiento del sistema debe ser único y exento de ambigüedades, evitando así la duplicación de funcionalidades. | + | **DRY** defiende que cada elemento del conocimiento del sistema debe ser único y exento de ambigüedades, evitando así la duplicación de funcionalidades. |
==== 5. Comentar con moderación ==== | ==== 5. Comentar con moderación ==== | ||
- | Los comentarios en el código deben ser utilizados con moderación y solo cuando sean realmente necesarios. Según la perspectiva de Uncle Bob, los comentarios pueden inducir a error, ya que suelen quedar obsoletos al modificarse el código. Por lo tanto, si se opta por comentar, debe ser de manera esencial y revisada conjuntamente con la versión del código. | + | Los comentarios en el código deben ser utilizados con moderación y solo cuando sean realmente necesarios. Según la perspectiva de **Uncle Bob**, los comentarios pueden inducir a error, ya que suelen quedar obsoletos al modificarse el código. Por lo tanto, si se opta por comentar, debe ser de manera esencial y revisada conjuntamente con la versión del código. |
==== 6. Manejo de errores ==== | ==== 6. Manejo de errores ==== | ||
- | El autor Michael Feathers destacó la importancia de tratar adecuadamente las excepciones en el desarrollo web. Los programadores son responsables de garantizar que el código siga funcionando incluso cuando surgen problemas. Tratar las excepciones de manera correcta es un aspecto clave en este proceso. | + | El autor **Michael Feathers** destacó la importancia de tratar adecuadamente las excepciones en el desarrollo web. Los programadores son responsables de garantizar que el código siga funcionando incluso cuando surgen problemas. Tratar las excepciones de manera correcta es un aspecto clave en este proceso. |
==== 7. Pruebas limpias ==== | ==== 7. Pruebas limpias ==== | ||
La realización de pruebas es una etapa crucial en la programación, y solo un código que ha pasado pruebas limpias puede considerarse verdaderamente limpio. Para ello, se deben cumplir ciertas reglas: | La realización de pruebas es una etapa crucial en la programación, y solo un código que ha pasado pruebas limpias puede considerarse verdaderamente limpio. Para ello, se deben cumplir ciertas reglas: | ||
- | * Rápido: Las pruebas deben ejecutarse rápidamente y en cualquier momento. | + | * **Rápido**: Las pruebas deben ejecutarse rápidamente y en cualquier momento. |
- | * Independiente: Las pruebas deben ser independientes para evitar efectos en cascada en caso de fallo. | + | * **Independiente**: Las pruebas deben ser independientes para evitar efectos en cascada en caso de fallo. |
- | * Repetible: Deben ser repetibles en diferentes entornos. | + | * **Repetible**: Deben ser repetibles en diferentes entornos. |
- | * Autovalidación: Las pruebas bien escritas devuelven respuestas claras (verdadero o falso) para evitar subjetividades en los errores. | + | * **Autovalidación**: Las pruebas bien escritas devuelven respuestas claras (verdadero o falso) para evitar subjetividades en los errores. |
- | * Puntual: Las pruebas deben ser escritas antes del código mismo, siguiendo estrictamente el criterio de puntualidad. | + | * **Puntual**: Las pruebas deben ser escritas antes del código mismo, siguiendo estrictamente el criterio de puntualidad. |
- | El Clean Code es un concepto arraigado que resuelve de manera eficiente uno de los principales desafíos que enfrentan muchos proyectos de desarrollo de sistemas: el mantenimiento((https://www.hostgator.mx/blog/clean-code-codigo-limpio/)). | + | El **Clean Code** es un concepto arraigado que resuelve de manera eficiente uno de los principales desafíos que enfrentan muchos proyectos de desarrollo de sistemas: el mantenimiento((https://www.hostgator.mx/blog/clean-code-codigo-limpio/)). |
[[ada:howto:sicoferp:factory:goodsoftwaredevelopmentpractices|←Volver atras]] | [[ada:howto:sicoferp:factory:goodsoftwaredevelopmentpractices|←Volver atras]] | ||