Muchas veces cuando estamos escribiendo vamos agregando comentarios al margen que nos permiten recordar ciertos detalles. Lo mismo ocurre al escribir códigos HTML ¡Y vaya qué beneficios tiene!

En este artículo, especialmente pensado para programadores, los que se ocupan del desarrollo web, te explicamos todo.

Desde qué son y para qué sirve comentar al crear o revisar un código, hasta cómo puedes empezar a incluirlos en el código fuente de tu página.

Índice de contenido

¿Qué son los comentarios en el código fuente?

Tal y como su nombre lo indica los comentarios en el código son un elemento que te permite agregar comentarios a un documento sin importar el lenguaje en que esté escrito (HTML, Javascript, Java, CSS, Python).

Específicamente en el caso de los comentarios HTML, son textos, que al incluirlos entre dos etiquetas HTML, te abren un espacio donde puedes dejar por escrito detalles importantes para cualquiera que trabaje con el código fuente de la página web.

Ejemplo de un comentario HTML

Es importante dejar claro que si bien estos comentarios no son detectables por un navegador, sí son leídos por los buscadores. Es decir, mientras que los visitantes de tu sitio web no van a poder leer estas líneas de texto, los buscadores sí.

De allí que sea tan importante cuidar la cantidad y calidad al comentar. Recuerda que mientras más información incluyas mayor será el tiempo para procesar tu página web. Nuestra recomendación es que agregues comentarios donde realmente amerita y evites los párrafos muy largos.

Un dato que quizás no sabías es que para ver el código de cualquier página basta con entrar a ella, hacer clic en el botón derecho del mouse y seleccionar la opción ver código fuente.

¿Cómo ver el código fuente de una página web?
¿Cómo ver el código fuente de una página web?
ilustracion-gobalo
Góbalo, Estrategia Digital
Madrid, España
5 - 3 recomendaciones
Software de creación de sitios webEstrategia DigitalMarketing de Contenidos
Conocer la agenciaarrow_forward
dreamtech-5-captura
Dreamtech5
Barcelona, España
3 - 3 recomendaciones
Creatividad y DiseñoEstrategia Digital
Conocer la agenciaarrow_forward
ideafoster-2-captura
Ideafoster
Barcelona, España
4 - 4 recomendaciones
Software de creación de sitios webEstrategia DigitalDesarrollo de la WebDesarrollo Web y SoftwareDiseño Web
Conocer la agenciaarrow_forward
v3rtice-ilustracion
V3rtice: Agencia de comunicación, digital y publicidad
Madrid, España
4,65 - 5 recomendaciones
Creatividad y DiseñoEstrategia Digital
Conocer la agenciaarrow_forward
aja_cover
AJA Publicidad
Madrid, España
4.5/5 - 8 recomendaciones
Software de creación de sitios webSEOEstrategia DigitalMarketingDesarrollo de la Web
Conocer la agenciaarrow_forward
creati
Creatiiv
Barcelona, Spain
5/5 - 0 recomendación
Software de creación de sitios webMarketing
Conocer la agenciaarrow_forward
captura
ttandem digital studio
Pamplona, Spain
4.5/5 - 6 recomendaciones
Software de creación de sitios webSEOCreatividad y DiseñoEstrategia DigitalMarketingMarketing de Contenidos
Conocer la agenciaarrow_forward
royal_cover
Royal Comunicación
Madrid, Spain
5/5 - 8 recomendaciones
Software de creación de sitios webSEOEstrategia DigitalMarketingDiseño Web
Conocer la agenciaarrow_forward
estimadojosealfredo_cover
Estimado José Alfredo
Valencia, Spain
5/5 - 1 recomendación
Creatividad y DiseñoEstrategia DigitalMarketing
Conocer la agenciaarrow_forward
lewis_cover
Lewis&Carroll – The Social Media Company
Barcelona, Spain
5/5 - 5 recomendaciones
Estrategia DigitalMarketingMarketing de Contenidos
Conocer la agenciaarrow_forward
cmg_cover
CMG Group
Barcelona, Spain
5/5 - 4 recomendaciones
Software de creación de sitios webSEOCreatividad y DiseñoEstrategia DigitalDiseño Web
Conocer la agenciaarrow_forward
mediatic_cover
Mediàtic · marketing strategy & PR
Barcelona, Spain
5/5 - 7 recomendaciones
Software de creación de sitios webSEOCreatividad y DiseñoEstrategia Digital
Conocer la agenciaarrow_forward
becool_cover
Becool Publicidad
Madrid, Spain
5/5 - 4 recomendaciones
Creatividad y DiseñoEstrategia DigitalMarketing
Conocer la agenciaarrow_forward
ween
Between comunicación
Madrid, Spain
5/5 - 9 recomendaciones
Creatividad y DiseñoEstrategia Digital
Conocer la agenciaarrow_forward
blubber-cover
Blubber Estudio Creativo
Madrid, Spain
5/5 - 2 recomendaciones
Software de creación de sitios webCreatividad y DiseñoEstrategia Digital
Conocer la agenciaarrow_forward
digo
CodigoNexo
Madrid, Spain
5/5 - 4 recomendaciones
Software de creación de sitios webSEOCreatividad y DiseñoEstrategia DigitalDesarrollo de la WebDiseño Web
Conocer la agenciaarrow_forward
nest
DNest Agency
Madrid, Spain
5/5 - 7 recomendaciones
Software de creación de sitios webSEOCreatividad y DiseñoEstrategia DigitalMarketingDesarrollo de la Web
Conocer la agenciaarrow_forward
nume
Numéricco
Zaragoza, Spain
5/5 - 7 recomendaciones
Software de creación de sitios webSEOEstrategia DigitalDesarrollo de la WebDiseño Web
Conocer la agenciaarrow_forward
wwwarcelona-cover
WWWARCELONA
Barcelona, Spain
5/5 - 14 recomendaciones
Software de creación de sitios webSEOCreatividad y DiseñoEstrategia DigitalMarketingDesarrollo de la WebDiseño Web
Conocer la agenciaarrow_forward
wecome-cover
Welcome
Madrid, Spain
5/5 - 5 recomendaciones
Software de creación de sitios webMarketing AutomationSEOSEACreatividad y DiseñoEstrategia DigitalMarketingDesarrollo Web y SoftwareMarketing de Contenidos
Conocer la agenciaarrow_forward
pool
Blackpool Digital
Barcelona, Spain
5/5 - 2 recomendaciones
SEOCreatividad y DiseñoEstrategia DigitalDesarrollo de la WebMarketing de Contenidos
Conocer la agenciaarrow_forward
dis
Leaders Comunicación
Asturias, Spain
5/5 - 5 recomendaciones
Software de creación de sitios webSEOCreatividad y DiseñoEstrategia Digital
Conocer la agenciaarrow_forward
rea
Reactiva
Barcelona, Spain
5/5 - 5 recomendaciones
Software de creación de sitios webSEOCreatividad y DiseñoEstrategia DigitalMarketingDiseño Web
Conocer la agenciaarrow_forward
immograf_cover
Immograf
Barcelona, Spain
5/5 - 5 recomendaciones
Software de creación de sitios webSEOEstrategia DigitalDesarrollo de la WebDiseño Web
Conocer la agenciaarrow_forward
wb-cover
Wild Branders
Granollers, Spain
5/5 - 7 recomendaciones
Software de creación de sitios webSEOCreatividad y DiseñoEstrategia DigitalMarketingDesarrollo Web y Software
Conocer la agenciaarrow_forward
inbuze-cover
Inbuze, Digital Marketing
Valencia, Spain
5/5 - 3 recomendaciones
Software de creación de sitios webMarketing AutomationSEOCreatividad y DiseñoEstrategia DigitalMarketingDesarrollo de la WebDesarrollo Web y SoftwareMarketing de ContenidosDiseño Web
Conocer la agenciaarrow_forward
ira
Iralta VR & Audiovisual Production
Madrid, Spain
5/5 - 5 recomendaciones
Estrategia Digital
Conocer la agenciaarrow_forward
the2
Starbrand*
Madrid, Spain
5/5 - 10 recomendaciones
Creatividad y DiseñoEstrategia Digital
Conocer la agenciaarrow_forward
bcm
BCM MARKETING B2B Barcelona
Barcelona, Spain
5/5 - 7 recomendaciones
SEOEstrategia DigitalMarketingDesarrollo de la Web
Conocer la agenciaarrow_forward
virg
Igluuu
Barcelona, Spain
5/5 - 8 recomendaciones
Creatividad y DiseñoEstrategia Digital
Conocer la agenciaarrow_forward
oso
? OSO.agency
Bilbao, Spain
5/5 - 3 recomendaciones
Software de creación de sitios webCreatividad y DiseñoEstrategia DigitalMarketing
Conocer la agenciaarrow_forward
adn
Bake250 Digital Agency
Barcelona, Spain
5/5 - 6 recomendaciones
Creatividad y DiseñoEstrategia Digital
Conocer la agenciaarrow_forward
crater
Crater
Madrid, Spain
5/5 - 7 recomendaciones
Software de creación de sitios webCreatividad y DiseñoEstrategia Digital
Conocer la agenciaarrow_forward
mari
DELAROSA Films
Granollers, Spain
5/5 - 4 recomendaciones
Creatividad y DiseñoEstrategia Digital
Conocer la agenciaarrow_forward
aqia
AQIA
La Garita, Spain
5/5 - 15 recomendaciones
Software de creación de sitios webSEOCreatividad y DiseñoEstrategia Digital
Conocer la agenciaarrow_forward
bsl
BSL MARKETING
Bilbao, Spain
5/5 - 1 recomendación
Software de creación de sitios webSEOCreatividad y DiseñoEstrategia DigitalDesarrollo de la Web
Conocer la agenciaarrow_forward
texel
Texel Filmmaking
Bilbao, Spain
5/5 - 2 recomendaciones
Estrategia Digital
Conocer la agenciaarrow_forward
modo
MODO
Barcelona, Spain
5/5 - 3 recomendaciones
SEOCreatividad y DiseñoEstrategia DigitalMarketingDesarrollo de la WebMarketing de Contenidos
Conocer la agenciaarrow_forward
ware
Syntec Soluciones TI
Barcelona, Spain
5/5 - 5 recomendaciones
Estrategia DigitalDesarrollo Web y SoftwareDiseño Web
Conocer la agenciaarrow_forward
mes
Visual Publinet S.L.
Vigo, Spain
5/5 - 7 recomendaciones
Software de creación de sitios webSEOEstrategia DigitalDesarrollo de la WebDiseño Web
Conocer la agenciaarrow_forward
mutat
EMUTATION NEW MEDIA
Madrid, Spain
5/5 - 0 recomendación
Software de creación de sitios webSEOEstrategia DigitalDesarrollo de la Web
Conocer la agenciaarrow_forward
lab
Creative Hack Lab
Pinto, Spain
5/5 - 4 recomendaciones
Software de creación de sitios webCreatividad y DiseñoEstrategia DigitalDesarrollo de la WebMarketing de ContenidosDiseño Web
Conocer la agenciaarrow_forward
tribal
Tribal Worldwide Spain
Madrid, Spain
5/5 - 0 recomendación
Software de creación de sitios webEstrategia DigitalMarketing
Conocer la agenciaarrow_forward
mm
Mercadotencias Agencia de Marketing y Vídeo
Zaragoza, Spain
5/5 - 5 recomendaciones
Software de creación de sitios webSEOEstrategia Digital
Conocer la agenciaarrow_forward
mile
Clapfy
Madrid, Spain
5/5 - 2 recomendaciones
Software de creación de sitios webCreatividad y DiseñoEstrategia DigitalDiseño Web
Conocer la agenciaarrow_forward
picky
Picky Brain
Barcelona, Spain
5/5 - 4 recomendaciones
Software de creación de sitios webCreatividad y DiseñoEstrategia DigitalDiseño Web
Conocer la agenciaarrow_forward
skala
????? ?????????
Madrid, Spain
5/5 - 6 recomendaciones
Software de creación de sitios webSEOMarketingDiseño Web
Conocer la agenciaarrow_forward
ash
ASH Proyectos Creativos
Madrid, Spain
5/5 - 7 recomendaciones
Software de creación de sitios webCreatividad y DiseñoEstrategia DigitalDiseño Web
Conocer la agenciaarrow_forward
sart
Startclub marketing
Madrid, Spain
5/5 - 0 recomendación
Software de creación de sitios webSEOEstrategia DigitalDiseño Web
Conocer la agenciaarrow_forward
sight
Nur Insight – Agencia Digital
Alcobendas, Spain
5/5 - 6 recomendaciones
Software de creación de sitios webSEOCreatividad y DiseñoEstrategia Digital
Conocer la agenciaarrow_forward
idea
Ideafoster
Barcelona, Spain
5/5 - 4 recomendaciones
Software de creación de sitios webCreatividad y DiseñoEstrategia DigitalMarketing
Conocer la agenciaarrow_forward
care
Comunicare Marketing 360
Madrid, Spain
5/5 - 70 recomendaciones
SEOCreatividad y DiseñoEstrategia DigitalMarketing
Conocer la agenciaarrow_forward
encia
Mood 359 Crea S.L.
Madrid, Spain
5/5 - 3 recomendaciones
Software de creación de sitios webSEOCreatividad y DiseñoEstrategia DigitalMarketing de ContenidosDiseño Web
Conocer la agenciaarrow_forward
craz
The Crazy Bunnies
Madrid, Spain
5/5 - 3 recomendaciones
Software de creación de sitios webSEOCreatividad y DiseñoMarketing
Conocer la agenciaarrow_forward
smile
SMiLE comunicacion
Madrid, Spain
5/5 - 3 recomendaciones
Software de creación de sitios webSEOEstrategia DigitalMarketing de ContenidosDiseño Web
Conocer la agenciaarrow_forward
publi
PubliUP
Arroyomolinos, Spain
5/5 - 10 recomendaciones
Software de creación de sitios webSEOEstrategia DigitalDiseño Web
Conocer la agenciaarrow_forward
aria
adiria
Madrid, Spain
5/5 - 3 recomendaciones
Software de creación de sitios webSEOCreatividad y DiseñoEstrategia DigitalMarketing
Conocer la agenciaarrow_forward
k
Kellenföl Advertising
Barcelona, Spain
5/5 - 6 recomendaciones
Software de creación de sitios webSEOCreatividad y DiseñoMarketing
Conocer la agenciaarrow_forward
wow
wowsrb
Sant Cugat del Vallès, Spain
5/5 - 2 recomendaciones
Software de creación de sitios webCreatividad y DiseñoEstrategia Digital
Conocer la agenciaarrow_forward
ciaw
Sociaw
Barcelona, Spain
5/5 - 3 recomendaciones
Creatividad y DiseñoEstrategia DigitalMarketingMarketing de Contenidos
Conocer la agenciaarrow_forward
vert-2
V3rtice: Agencia de comunicación, digital y publicidad
Barcelona, Spain
5/5 - 4 recomendaciones
SEOCreatividad y DiseñoEstrategia Digital
Conocer la agenciaarrow_forward
lift
Lifting Group
Barcelona, Spain
5/5 - 0 recomendación
Software de creación de sitios webSEOEstrategia DigitalMarketingDesarrollo de la Web
Conocer la agenciaarrow_forward
load
Rload Studio
Madrid, Spain
5/5 - 12 recomendaciones
Software de creación de sitios webCreatividad y DiseñoEstrategia Digital
Conocer la agenciaarrow_forward
deli
Im3diA comunicación
Albacete, Spain
5/5 - 18 recomendaciones
Software de creación de sitios webEstrategia DigitalMarketingDesarrollo de la Web
Conocer la agenciaarrow_forward
avance
Avance Comunicación S.A.
Madrid, Spain
5/5 - 2 recomendaciones
Creatividad y DiseñoEstrategia DigitalMarketing
Conocer la agenciaarrow_forward
site
adn studio, agencia creativa de comunicación
Barcelona, Spain
5/5 - 3 recomendaciones
Creatividad y DiseñoMarketingDiseño Web
Conocer la agenciaarrow_forward
baba
Babalua
Madrid, Spain
5/5 - 4 recomendaciones
Software de creación de sitios webSEOCreatividad y DiseñoEstrategia DigitalDiseño Web
Conocer la agenciaarrow_forward
croma
Croma Studio
Barcelona, Spain
5/5 - 10 recomendaciones
Creatividad y DiseñoEstrategia Digital
Conocer la agenciaarrow_forward
hombre
El Hombre del Paraguas
Madrid, Spain
5/5 - 0 recomendación
Creatividad y DiseñoEstrategia Digital
Conocer la agenciaarrow_forward
estu
Estudio Brainstorm, S.L.
Barcelona, Spain
5/5 - 4 recomendaciones
Software de creación de sitios webSEOCreatividad y DiseñoEstrategia DigitalMarketingMarketing de Contenidos
Conocer la agenciaarrow_forward
facto
Factoría de Proyectos
Barcelona, Spain
5/5 - 3 recomendaciones
Software de creación de sitios webCreatividad y DiseñoEstrategia Digital
Conocer la agenciaarrow_forward
mmb
MWLB (MeelowLab)
Madrid, Spain
5/5 - 10 recomendaciones
SEOCreatividad y DiseñoMarketingMarketing de Contenidos
Conocer la agenciaarrow_forward
pol
Pixelarte
Valencia, Spain
5/5 - 0 recomendación
SEOEstrategia DigitalDiseño Web
Conocer la agenciaarrow_forward
woks
TheWokis
Madrid, Spain
5/5 - 0 recomendación
Creatividad y DiseñoEstrategia DigitalDesarrollo de la WebDiseño Web
Conocer la agenciaarrow_forward
acorn
Acorn Digital Agency
Barcelona, Spain
5/5 - 8 recomendaciones
Software de creación de sitios webSEOCreatividad y DiseñoEstrategia DigitalMarketingDesarrollo de la Web
Conocer la agenciaarrow_forward
dina
Dinamicbrain
Madrid, Spain
5/5 - 8 recomendaciones
Software de creación de sitios webSEOEstrategia DigitalMarketing de Contenidos
Conocer la agenciaarrow_forward
dose
DOSEME Agencia De Creatividad S.A.
Barcelona, Spain
5/5 - 5 recomendaciones
Creatividad y DiseñoEstrategia Digital
Conocer la agenciaarrow_forward
metro
Ycp Creativos S.L
Seville, Spain
5/5 - 3 recomendaciones
Software de creación de sitios webCreatividad y DiseñoEstrategia Digital
Conocer la agenciaarrow_forward
lewis
LEWIS Communications
Madrid, Spain
5/5 - 0 recomendación
SEOEstrategia DigitalMarketingDesarrollo de la Web
Conocer la agenciaarrow_forward
pala
Paladina Marketing
Madrid, Spain
5/5 - 0 recomendación
Software de creación de sitios webSEOEstrategia Digital
Conocer la agenciaarrow_forward
dea
ME GUSTA LA IDEA
Madrid, Spain
5/5 - 0 recomendación
SEOCreatividad y DiseñoEstrategia DigitalMarketing
Conocer la agenciaarrow_forward
arti
Artichokes Creatividad
Madrid, Spain
5/5 - 18 recomendaciones
Software de creación de sitios webEstrategia Digital
Conocer la agenciaarrow_forward
juist
Jiuston Advertising
Barcelona, Spain
5/5 - 3 recomendaciones
Software de creación de sitios webCreatividad y DiseñoEstrategia Digital
Conocer la agenciaarrow_forward
summ
Summum Marketing
Valladolid, Spain
5/5 - 6 recomendaciones
Software de creación de sitios webMarketing AutomationSEOEstrategia DigitalMarketing
Conocer la agenciaarrow_forward
g4
G4 Canarias
Santa Cruz de Tenerife, Spain
5/5 - 0 recomendación
Creatividad y DiseñoEstrategia DigitalMarketing
Conocer la agenciaarrow_forward
tal
Talentum Digital
Madrid, Spain
5/5 - 21 recomendaciones
SEOEstrategia DigitalDiseño Web
Conocer la agenciaarrow_forward
lyra
lyra.
Madrid, Spain
5/5 - 7 recomendaciones
Software de creación de sitios webSEOCreatividad y DiseñoEstrategia DigitalMarketingDesarrollo de la Web
Conocer la agenciaarrow_forward
pinch
Pinchaaqui.es
Madrid, Spain
5/5 - 7 recomendaciones
Software de creación de sitios webEstrategia DigitalMarketingDesarrollo Web y Software
Conocer la agenciaarrow_forward
roi
Roi Scroll
Vigo, Spain
5/5 - 6 recomendaciones
Estrategia Digital
Conocer la agenciaarrow_forward
both
Both
Barcelona, Spain
5/5 - 0 recomendación
Creatividad y DiseñoEstrategia Digital
Conocer la agenciaarrow_forward
nec
Perseo
Madrid, Spain
5/5 - 3 recomendaciones
Creatividad y DiseñoEstrategia DigitalDiseño Web
Conocer la agenciaarrow_forward
brem
El Club Bremen
Bilbao, Spain
5/5 - 3 recomendaciones
Software de creación de sitios webCreatividad y DiseñoEstrategia Digital
Conocer la agenciaarrow_forward
sma
Smaver
Madrid, Spain
5/5 - 3 recomendaciones
SEOEstrategia Digital
Conocer la agenciaarrow_forward
focus
Webfocus
Arinaga, Spain
5/5 - 3 recomendaciones
Software de creación de sitios webMarketing
Conocer la agenciaarrow_forward
vert
Factoría de Ideas Felices
Madrid, Spain
5/5 - 14 recomendaciones
Creatividad y DiseñoEstrategia DigitalMarketing
Conocer la agenciaarrow_forward
dna
ALANA CONSULTORES COMUNICACIÓN
Madrid, Spain
5/5 - 2 recomendaciones
Creatividad y DiseñoEstrategia DigitalMarketingMarketing de Contenidos
Conocer la agenciaarrow_forward
prop
Smart Productions
Barcelona, Spain
5/5 - 7 recomendaciones
Estrategia Digital
Conocer la agenciaarrow_forward
elmer
We Are Elmer, Branding & Marketing Digital
Barcelona, Spain
5/5 - 9 recomendaciones
Software de creación de sitios webSEOEstrategia DigitalDesarrollo de la WebMarketing de Contenidos
Conocer la agenciaarrow_forward
benny
VNBenny
Murcia, Spain
5/5 - 1 recomendación
Software de creación de sitios webSEOCreatividad y DiseñoEstrategia DigitalMarketingDesarrollo de la WebDiseño Web
Conocer la agenciaarrow_forward
wol
Wontech consultoria tecnologica
Badalona, Spain
5/5 - 0 recomendación
Software de creación de sitios webMarketing AutomationEstrategia DigitalDesarrollo Web y Software
Conocer la agenciaarrow_forward
all
Clicategia
Madrid, Spain
5/5 - 5 recomendaciones
Software de creación de sitios webSEOCreatividad y DiseñoEstrategia DigitalMarketingDiseño Web
Conocer la agenciaarrow_forward
hub
AkuaroHub
Barcelona, Spain
5/5 - 3 recomendaciones
Software de creación de sitios webEstrategia DigitalDesarrollo de la Web
Conocer la agenciaarrow_forward
qusha
Estudio Qusha
Seville, Spain
5/5 - 2 recomendaciones
Software de creación de sitios webEstrategia Digital
Conocer la agenciaarrow_forward
value
Thevaluefactory
Barcelona, Spain
5/5 - 5 recomendaciones
Software de creación de sitios webEstrategia DigitalMarketingDesarrollo de la WebDiseño Web
Conocer la agenciaarrow_forward
well
UPWELLING
Seville, Spain
5/5 - 4 recomendaciones
Software de creación de sitios webCreatividad y DiseñoEstrategia Digital
Conocer la agenciaarrow_forward
digi
Digitus
Castellón de la Plana, Spain
5/5 - 1 recomendación
Software de creación de sitios webSEOCreatividad y DiseñoEstrategia DigitalMarketingDiseño Web
Conocer la agenciaarrow_forward
tech
Dreamtech5
Molina de Segura, Spain
5/5 - 3 recomendaciones
Estrategia Digital
Conocer la agenciaarrow_forward
telia
Creartelia
Madrid, Spain
5/5 - 10 recomendaciones
Software de creación de sitios webCreatividad y DiseñoEstrategia DigitalMarketingDiseño Web
Conocer la agenciaarrow_forward
what
Whaaat.tv
Barcelona, Spain
5/5 - 3 recomendaciones
Estrategia Digital
Conocer la agenciaarrow_forward
bird
BlackBird Films
Madrid, Spain
5/5 - 7 recomendaciones
Creatividad y DiseñoEstrategia Digital
Conocer la agenciaarrow_forward
smark
Smarkt
Madrid, Spain
5/5 - 10 recomendaciones
Software de creación de sitios webMarketing AutomationSEOCreatividad y DiseñoEstrategia DigitalMarketingMarketing de Contenidos
Conocer la agenciaarrow_forward
ripli
Ripli
Madrid, Spain
5/5 - 3 recomendaciones
Software de creación de sitios webEstrategia Digital
Conocer la agenciaarrow_forward
making
Nomadmaking
Madrid, Spain
5/5 - 4 recomendaciones
Software de creación de sitios webSEOCreatividad y DiseñoEstrategia Digital
Conocer la agenciaarrow_forward
calia
Multiplicalia
Seville, Spain
5/5 - 0 recomendación
Software de creación de sitios webSEOEstrategia DigitalDiseño Web
Conocer la agenciaarrow_forward
cv
Overside Lab
Barcelona, Spain
5/5 - 2 recomendaciones
Software de creación de sitios webSEOCreatividad y DiseñoEstrategia Digital
Conocer la agenciaarrow_forward
sing
L’atout consulting agency
Barcelona, Spain
5/5 - 1 recomendación
Software de creación de sitios webCreatividad y DiseñoEstrategia DigitalMarketing
Conocer la agenciaarrow_forward
rank
Rankerss
Albacete, Spain
5/5 - 4 recomendaciones
Software de creación de sitios webSEOMarketingDiseño Web
Conocer la agenciaarrow_forward
tri
Trilogi the eCommerce agency
Barcelona, Spain
5/5 - 3 recomendaciones
Marketing AutomationSEOEstrategia Digital
Conocer la agenciaarrow_forward
proy
Proyectados
Barcelona, Spain
5/5 - 3 recomendaciones
Estrategia DigitalMarketing
Conocer la agenciaarrow_forward
caja
La Caja Company
Madrid, Spain
5/5 - 6 recomendaciones
Software de creación de sitios webEstrategia DigitalMarketing de Contenidos
Conocer la agenciaarrow_forward
vendo
Chovendo – Estrategias Creativas
Tinocas, Spain
5/5 - 4 recomendaciones
Software de creación de sitios webSEOCreatividad y DiseñoEstrategia DigitalMarketing
Conocer la agenciaarrow_forward
smart
Smartup
Salamanca, Spain
5/5 - 4 recomendaciones
SEOCreatividad y DiseñoEstrategia DigitalMarketing
Conocer la agenciaarrow_forward
port
Port d’Idees
Barcelona, Spain
5/5 - 4 recomendaciones
SEOEstrategia Digital
Conocer la agenciaarrow_forward
menta
Digital Menta
Madrid, Spain
5/5 - 3 recomendaciones
SEOCreatividad y DiseñoEstrategia DigitalMarketing
Conocer la agenciaarrow_forward
smav
Smaver Productora Audiovisual
Madrid, Spain
5/5 - 4 recomendaciones
SEOCreatividad y DiseñoEstrategia Digital
Conocer la agenciaarrow_forward

¿Para qué sirven los comentarios en el código HTML?

Desarrolladores e ingenieros recurren a los comentarios HTML por diferentes razones, algunas de ellas son:

  1. Para dejar registro de cuándo y por quién fue modificado el código. Como bien es sabido, una página web sufre variaciones a lo largo del tiempo. Hay algunas que son visibles para cualquier usuario, y otras que son netamente para mejorar el rendimiento del mismo. Desde Sortlist queremos recomendarte hacer uso de los comentarios HTML para dejar nota de cuándo hiciste estos cambios y exactamente qué fue que modificaste. Esta información va a ayudar a que todas las personas involucradas con el funcionamiento del sitio tengan a disposición los datos de las ediciones que se han realizado y para qué.
  2. Para hacer que el código sea más fácil de entender. Cuando se trabaja en proyectos muy largos es posible que olvides para qué hiciste un código determinado, por qué está hecho de esa forma, o cuál función cumple. También puede darse el caso de que terceras personas trabajen con tu código y no tengan claro por qué creaste el código de esa manera. Comentar aquí explicando las respuestas a estas preguntas no sólo va a facilitar la legibilidad del código, sino que además te va a ayudar a recordar por qué lo hiciste de esa manera y no de otra.
  3. Para dejar feedback. Si estás trabajando con un equipo de desarrolladores es probable que, tú o alguien más, deba asumir la responsabilidad de revisar el código fuente de la web para cerciorarse de que todo está en orden. En este caso, los comentarios son un recurso ideal para dejar anotaciones sobre detalles que requieren atención para garantizar el rendimiento óptimo de la página.
  4. A manera de ensayo y error. Habrá momentos en los que te enfrentes a situaciones donde no sabes a ciencia cierta la razón detrás de una falla en la página web. A medida que vas revisando, y haciendo diferentes pruebas, puedes ir dejando comentarios HTML que te permiten saber qué estrategias ya has intentado, cuáles han sido los resultados obtenidos y qué secciones ya has revisado.
  5. Para depurar un código. También es cierto que al agregar un código nuevo a tu página web es posible que te enfrentes a algunos errores. Por lo que te recomendamos hacer pruebas escondiendo el código nuevo detrás de un comentario para así depurarlo y ver dónde podría estar la falla.

Pasos para hacer comentarios HTML

Hasta aquí hemos revisado qué son y para qué sirven los comentarios en los códigos fuente, pero ¿cómo puedes empezar a hacerlos?

Si bien esta función está disponible en los diferentes lenguajes de programación (CSS, Javascript, Java, Python), a efectos de este artículo te compartimos el paso a paso para hacerlo en HTML:

Paso 1: Dentro del código fuente de tu sitio web, ve al lugar específico donde quieres dejar el comentario.

Paso 2: Abre una etiqueta HTML con el símbolo menor que: <

Paso 3: Seguido incluye un signo de cierre de exclamación y dos guiones:

Paso 4: Ahora es cuando empiezas a escribir tu comentario:

Paso 5: Para cerrar el comentario debes agregar dos guiones y el símbolo de mayor que:

El código para insertar un comentario debe verse así:

Para ponerlo más sencillo, el comentario en este lenguaje de programación es una etiqueta HTML que empieza con un signo de exclamación y termina con dos guiones.

Ejemplo de un comentario dentro de una etiqueta HTML

Pasos para comentar en varias líneas

En caso de quieras, o tengas que, agregar un comentario de varias líneas de texto, entonces te recomendamos seguir estos pasos. Básicamente lo primeros son los mismos que en el caso anterior, la diferencia está en la manera de escribir las líneas de código.

Paso 1: Abre una etiqueta HTML con el símbolo menor que: <

Paso 2: Seguido incluye un signo de cierre de exclamación y 2 guiones:

Paso 3: En la línea siguente empezar a escribir el comentario:

Empieza a comentar aquí.

Sigues aquí.

Y sigues tantas líneas como sea necesario.

Paso 4: Y cierras el comentario al poner 2 guiones y el símbolo de mayor que en la línea siguiente:

Empieza a poner tu texto aquí.

Sigues aquí.

Y sigues tantas líneas como sea necesario.

–>

Ejemplo de un comentario HTML de varias líneas

Recomendaciones básicas para trabajar con comentarios HTML

A manera de cierre queremos dejarte algunas recomendaciones que te ayudarán a sacar el mayor provecho de este recurso sin afectar la velocidad de carga o tiempos de respuesta de tu página web.

Nunca dupliques el código dentro de un comentario

No solo resta valor al comentario, sino que afecta el rendimiento de la página web. Procura hacer uso de este recurso cuando realmente lo amerite.

Agregar comentarios no te excluye de tener que escribir bien un código

Este no es un espacio para colocar información que debería aparecer dentro del código HTML. Recuerda que como desarrollador debes enfocarte en escribir códigos lo suficientemente buenos para que no necesiten de un comentario que lo complemente.

Los comentarios están para aclarar los códigos

Si bien hemos dicho que no debes escribir comentarios muy largos, también es cierto que estos existen para satisfacer las diferentes necesidades que compartimos más arriba. Cuando estés escribiendo un código hazlo pensando en que lo va a leer un tercero. Responde aquí las preguntas que pudieran surgir.

Usa este espacio para compartir la fuente original

Todo programador recurre a códigos que consigue en línea. Cuando lo hagas, procura agregar la fuente original en un comentario. Así, cualquiera que esté involucrado en el proyecto, puede consultarla y tener un mejor panorama de qué estabas tratando de solucionar y por qué esa es la mejor forma.

Los comentarios no se limitan a códigos nuevos

Los comentarios son el espacio ideal para llevar registro de cuando hayas tenido que depurar un código. Hacer algún ajuste al sitio, o modificar alguna sección.

Conclusión

Como puedes ver trabajar con comentarios en los diferentes lenguajes de programación tiene una serie de beneficios que solo hacen que tú trabajo y el de tu equipo sea más sencillo.

Es una manera positiva de ser parte de un equipo, de abrir un espacio para aclarar dudas, hacer seguimiento, dejar puntos claros y ayudarse los unos a los otros.