Comentarios en: Comentarios en los CSS ¿Como? http://www.anieto2k.com/2007/10/31/comentarios-en-los-css-%c2%bfcomo/ Desarrollo web, Wordpress, y alguna cosilla más Sun, 12 Feb 2012 12:01:25 +0000 hourly 1 http://wordpress.org/?v=3.3.1 Por: Ordenación del CSS | aNieto2K http://www.anieto2k.com/2007/10/31/comentarios-en-los-css-%c2%bfcomo/#comment-54195 Ordenación del CSS | aNieto2K Thu, 19 Feb 2009 21:43:48 +0000 http://www.anieto2k.com/2007/10/31/comentarios-en-los-css-%c2%bfcomo/#comment-54195 [...] que hace ya mucho tiempo hablamos con Daniel Mota sobre la cantidad de comentarios en nuestros CSS, pero aún podemos ser más meticulosos con estos ficheros. Podemos definir una ordenación básica [...] [...] que hace ya mucho tiempo hablamos con Daniel Mota sobre la cantidad de comentarios en nuestros CSS, pero aún podemos ser más meticulosos con estos ficheros. Podemos definir una ordenación básica [...]

]]> Por: Entropía http://www.anieto2k.com/2007/10/31/comentarios-en-los-css-%c2%bfcomo/#comment-45834 Entropía Tue, 08 Apr 2008 19:01:30 +0000 http://www.anieto2k.com/2007/10/31/comentarios-en-los-css-%c2%bfcomo/#comment-45834 Comentar el código en su justa medida siempre es buena práctica. En primer lugar para sosiego del propio autor que tiene que trabajar con volúmenes de ficheros, complejidades o periodos de tiempo no triviales. Y en segundo lugar para beneficio del desarrollo o mantenimiento compartido. En mi caso, suelo trabajar con un proyecto "fuente" en el que comento rigurosamente tanto las hojas CSS, como los archivos de script. Pero luego dispongo de una tarea automatizada que "compila" una versión para despliegue del proyecto y, entre otras cosas, compacta dichos archivos (o incluso fusiona algunos de ellos) con algún "minifier" como YUI Compressor. Comentar el código en su justa medida siempre es buena práctica. En primer lugar para sosiego del propio autor que tiene que trabajar con volúmenes de ficheros, complejidades o periodos de tiempo no triviales. Y en segundo lugar para beneficio del desarrollo o mantenimiento compartido.

En mi caso, suelo trabajar con un proyecto “fuente” en el que comento rigurosamente tanto las hojas CSS, como los archivos de script. Pero luego dispongo de una tarea automatizada que “compila” una versión para despliegue del proyecto y, entre otras cosas, compacta dichos archivos (o incluso fusiona algunos de ellos) con algún “minifier” como YUI Compressor.

]]> Por: CSS Frame, estructura tus CSS de una vez por todas | aNieto2K http://www.anieto2k.com/2007/10/31/comentarios-en-los-css-%c2%bfcomo/#comment-45820 CSS Frame, estructura tus CSS de una vez por todas | aNieto2K Tue, 08 Apr 2008 13:19:48 +0000 http://www.anieto2k.com/2007/10/31/comentarios-en-los-css-%c2%bfcomo/#comment-45820 [...] presente en todo momento.  Principalmente por que para mantener una aplicación web es crucial que el código sea lo más claro y conciso posible, lo ideal sería que de una pasada podamos descubrir donde se encuentra lo que estamos [...] [...] presente en todo momento.  Principalmente por que para mantener una aplicación web es crucial que el código sea lo más claro y conciso posible, lo ideal sería que de una pasada podamos descubrir donde se encuentra lo que estamos [...]

]]> Por: el lu http://www.anieto2k.com/2007/10/31/comentarios-en-los-css-%c2%bfcomo/#comment-44606 el lu Tue, 26 Feb 2008 04:26:24 +0000 http://www.anieto2k.com/2007/10/31/comentarios-en-los-css-%c2%bfcomo/#comment-44606 yo uso para mis css solo comentarios de estructura como dijeron algunos; /* cuerpo */ . /* header */ . /* sidebar */ blabla creo que todo lo demas es prescindible si los datos estan ordenados y aparte contando con que despues de la aclaracion de que vienen los estilos para /* sidebar */, supongamos, las clases van a tenr algun tipo de identificador, como por ej #sidebar {} #sidebar .header h1 {} y asi saludos. yo uso para mis css solo comentarios de estructura como dijeron algunos; /* cuerpo */ . /* header */ . /* sidebar */ blabla

creo que todo lo demas es prescindible si los datos estan ordenados y aparte
contando con que despues de la aclaracion de que vienen los estilos para /* sidebar */, supongamos, las clases van a tenr algun tipo de identificador, como por ej

#sidebar {} #sidebar .header h1 {} y asi

saludos.

]]> Por: Lucas (Wydblog) http://www.anieto2k.com/2007/10/31/comentarios-en-los-css-%c2%bfcomo/#comment-41522 Lucas (Wydblog) Fri, 02 Nov 2007 20:11:28 +0000 http://www.anieto2k.com/2007/10/31/comentarios-en-los-css-%c2%bfcomo/#comment-41522 Desde mi punto de vista es algo que no es impresindible... trankilamente podriamos hacer nuestro css sin eso... saludos, Lucas. Desde mi punto de vista es algo que no es impresindible… trankilamente podriamos hacer nuestro css sin eso…

saludos,

Lucas.

]]> Por: Roberto http://www.anieto2k.com/2007/10/31/comentarios-en-los-css-%c2%bfcomo/#comment-41511 Roberto Fri, 02 Nov 2007 14:26:34 +0000 http://www.anieto2k.com/2007/10/31/comentarios-en-los-css-%c2%bfcomo/#comment-41511 Interesante artículo. El asunto de llevar el estándar javaDoc a Css lleva su rato, y en mi opinión tiene sus ventajas. En mi experiencia, cuando se trabaja en equipo, los comentarios pueden hacer una gran diferencia en la productividad y en evitar explicar lo mismo a distintas personas. Súmale a eso el hecho de trabajar en layouts con grilla, y agrégale el hecho de que un solo miembro del equipo entiende Css y tendrás un problemón. Puede parecer demasiada documentación, pero para los desarrolladores Java es algo conocido. Lamentablemente, aún no existe ninguna forma medianamente automatizada para hacer estos comentarios (como si la hay para el javaDoc), lo que hace la tarea bastante penosa; y pese a que es posible optimizar el peso del css y limpiar el código cuando se va a producción, todavía hay mucho trabajo a mano. En suma, creo que hay que darle tiraje a la chimenea. Imagino que en algún momento, los tipos detrás de IDE's, pensarán en los sufridos que hacen css y saldrán con algo útil =) Interesante artículo.
El asunto de llevar el estándar javaDoc a Css lleva su rato, y en mi opinión tiene sus ventajas.
En mi experiencia, cuando se trabaja en equipo, los comentarios pueden hacer una gran diferencia en la productividad y en evitar explicar lo mismo a distintas personas.
Súmale a eso el hecho de trabajar en layouts con grilla, y agrégale el hecho de que un solo miembro del equipo entiende Css y tendrás un problemón.

Puede parecer demasiada documentación, pero para los desarrolladores Java es algo conocido. Lamentablemente, aún no existe ninguna forma medianamente automatizada para hacer estos comentarios (como si la hay para el javaDoc), lo que hace la tarea bastante penosa; y pese a que es posible optimizar el peso del css y limpiar el código cuando se va a producción, todavía hay mucho trabajo a mano.

En suma, creo que hay que darle tiraje a la chimenea. Imagino que en algún momento, los tipos detrás de IDE’s, pensarán en los sufridos que hacen css y saldrán con algo útil =)

]]> Por: Olga Carreras http://www.anieto2k.com/2007/10/31/comentarios-en-los-css-%c2%bfcomo/#comment-41500 Olga Carreras Fri, 02 Nov 2007 08:06:37 +0000 http://www.anieto2k.com/2007/10/31/comentarios-en-los-css-%c2%bfcomo/#comment-41500 Yo prefiero documentar la CSS aparte para no recargar el fichero. Yo prefiero documentar la CSS aparte para no recargar el fichero.

]]> Por: jorgerock http://www.anieto2k.com/2007/10/31/comentarios-en-los-css-%c2%bfcomo/#comment-41481 jorgerock Thu, 01 Nov 2007 20:12:24 +0000 http://www.anieto2k.com/2007/10/31/comentarios-en-los-css-%c2%bfcomo/#comment-41481 Está de más... con comentar lo de /** estructura **/ ya basta. Está de más… con comentar lo de /** estructura **/ ya basta.

]]> Por: aNieto2k http://www.anieto2k.com/2007/10/31/comentarios-en-los-css-%c2%bfcomo/#comment-41476 aNieto2k Thu, 01 Nov 2007 17:01:02 +0000 http://www.anieto2k.com/2007/10/31/comentarios-en-los-css-%c2%bfcomo/#comment-41476 Pues parece que soy el único que ve este sistema de comentarios "más o menos" práctico e incluso necesario. Por 2 motivos: 1) Si programamos para nosotros, dentro de 1 año, podremos leer el código y entender por que hicimos eso en ese elemento concreto. 2) Si programamos con más gente, ayudamos a entender nuestro código que generalmente es dificil de entender por los demás. Por experiencia, puedo decir que por muchos comentarios que se pongan, nunca son suficientes. El tema del peso del CSS, nos pone en una encrucijada, ya que el peso es un factor a tener en cuenta en nuestros diseños. Por eso usar un parseador que elimine los comentarios de nuestro CSS antes de que se ponga en producción podría ayudarnos a aligerar ese peso, disponiendo siempre de un documento documentado (xD). Pues parece que soy el único que ve este sistema de comentarios “más o menos” práctico e incluso necesario.

Por 2 motivos:

1) Si programamos para nosotros, dentro de 1 año, podremos leer el código y entender por que hicimos eso en ese elemento concreto.

2) Si programamos con más gente, ayudamos a entender nuestro código que generalmente es dificil de entender por los demás.

Por experiencia, puedo decir que por muchos comentarios que se pongan, nunca son suficientes.

El tema del peso del CSS, nos pone en una encrucijada, ya que el peso es un factor a tener en cuenta en nuestros diseños. Por eso usar un parseador que elimine los comentarios de nuestro CSS antes de que se ponga en producción podría ayudarnos a aligerar ese peso, disponiendo siempre de un documento documentado (xD).

]]> Por: acido http://www.anieto2k.com/2007/10/31/comentarios-en-los-css-%c2%bfcomo/#comment-41474 acido Thu, 01 Nov 2007 15:14:57 +0000 http://www.anieto2k.com/2007/10/31/comentarios-en-los-css-%c2%bfcomo/#comment-41474 Estoy de acuerdo con que es bastante el comentario "tan explicado". Yo lo hago solo en casos donde mi función se limita a crear TPL(templates) para que luego otro los integre. Comentarlo de ésta manera lleva unos minutos(15/20) al final de maquetarlo todo y sirve para que no pierdas tiempo(10mn ó +) cada vez que tengan que venir a preguntarte porque no se rompe algo, o porque al poner la clase, no se como las demás. Aunque hay que reconocer que algunos ni siquiera se han molestado en abrir el css, será porque nadie tiene la costumbre de "comentar nada" Estoy de acuerdo con que es bastante el comentario “tan explicado”. Yo lo hago solo en casos donde mi función se limita a crear TPL(templates) para que luego otro los integre.
Comentarlo de ésta manera lleva unos minutos(15/20) al final de maquetarlo todo y sirve para que no pierdas tiempo(10mn ó +) cada vez que tengan que venir a preguntarte porque no se rompe algo, o porque al poner la clase, no se como las demás.
Aunque hay que reconocer que algunos ni siquiera se han molestado en abrir el css, será porque nadie tiene la costumbre de “comentar nada”

]]>