Conversation

Notices

1. jartigag (jartigag@mastodon.social)'s status on Thursday, 08-Jun-2023 17:48:40 UTC jartigag

   in reply to

   • Ekaitz Zárraga 👹
   • fanta ✅️

   @ekaitz_zarraga
   @fanta no lo pillo. comment es una variable? para qué querrías evaluarla?

   • Ekaitz Zárraga 👹 (ekaitz_zarraga@mastodon.social)'s status on Thursday, 08-Jun-2023 17:48:41 UTC Ekaitz Zárraga 👹

     in reply to

     • fanta ✅️

     @fanta yo en clojure y scheme a veces pongo valores de retorno en un comentario que pueda evaluarse:

     ; Returns
     (comment '(1 2 3 4))

     Y así.
     Y el ascii art que no falte.

   • Ekaitz Zárraga 👹 (ekaitz_zarraga@mastodon.social)'s status on Thursday, 08-Jun-2023 17:48:42 UTC Ekaitz Zárraga 👹

     in reply to

     • fanta ✅️

     @fanta Yo sí que creo que el código bien escrito se documenta a sí mismo. Sólo que nunca he visto a NADIE hacer código de esa calidad.
     Como ese estándar de calidad es difícil de alcanzar es mejor poner notitas por si acaso.

     "Querido programador: No eres tan bueno como crees."

   • fanta ✅️ (fanta@mastodon.green)'s status on Thursday, 08-Jun-2023 17:48:42 UTC fanta ✅️

     in reply to

     • Ekaitz Zárraga 👹

     @ekaitz_zarraga un poco de art ascii leñes. Unas tablas con los posibles valores o parámetros, ... no se. Algunas veces ayuda a tu yo futuro

   • fanta ✅️ (fanta@mastodon.green)'s status on Thursday, 08-Jun-2023 17:48:43 UTC fanta ✅️

     Sobre la auto-documentación

     Creo que nos engañarnos si nos tomamos en serio lo de "el código bien escrito se documenta a si mismo"

     Es buena cosa declarar bien variables y funciones con nombres que indiquen lo que hacen, no duplicar, ...

     Pero por dios no pasa nada por dejar un triste comentario, son gratis. La documentación es código también y como ocurre con los libros 📚... no tiene mucho sentido que no lleven un índice

     ¿Tanto cuesta un comentario en el crontab?, al inicio de un script, ...