<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
  <channel>
    <title>Documentación on The Flip Flop Developer</title>
    <link>https://cristiansuarez.dev/tags/documentaci%C3%B3n/</link>
    <description>Recent content in Documentación on The Flip Flop Developer</description>
    <generator>Hugo</generator>
    <language>es</language>
    <lastBuildDate>Sat, 16 Jun 2018 23:00:00 +0000</lastBuildDate>
    <atom:link href="https://cristiansuarez.dev/tags/documentaci%C3%B3n/index.xml" rel="self" type="application/rss+xml" />
    <item>
      <title>Olores del código: comentarios y entorno</title>
      <link>https://cristiansuarez.dev/libros/olores-del-codigo-comentarios-y-entorno/</link>
      <pubDate>Sat, 16 Jun 2018 23:00:00 +0000</pubDate>
      <guid>https://cristiansuarez.dev/libros/olores-del-codigo-comentarios-y-entorno/</guid>
      <description>&lt;p&gt;Existen muchas cosas que no huelen bien en el código y a continuación vas a
poder ver las referentes a comentarios y al entorno. Esta es una publicación
parte de una serie de publicaciones que haré referentes a olores del código.&lt;/p&gt;
&lt;h2 id=&#34;comentarios&#34;&gt;Comentarios&lt;/h2&gt;
&lt;p&gt;Se que lo hemos hablado en varias ocasiones pero una vez más, los comentarios
no son una mejora del código. Al contrario, suelen entorpecer más de lo que
ayudan por las siguientes razones:&lt;/p&gt;</description>
    </item>
    <item>
      <title>Comentarios</title>
      <link>https://cristiansuarez.dev/libros/comentarios/</link>
      <pubDate>Thu, 22 Mar 2018 00:00:00 +0000</pubDate>
      <guid>https://cristiansuarez.dev/libros/comentarios/</guid>
      <description>&lt;p&gt;Comentarios, un buen comentario puede ser muy útil, puede ser la mejor ayuda
que encontraste ese día pero, por otra parte pueden ser tan dañinos y malvados
que ni el mismo autor de ellos sabrá porque están ahí. La mala noticia es que
la mayoría de las veces los comentarios entran en este segundo grupo.&lt;/p&gt;
&lt;h2 id=&#34;malos-comentarios&#34;&gt;Malos comentarios&lt;/h2&gt;
&lt;h3 id=&#34;no-arreglan-mal-código&#34;&gt;No arreglan mal código&lt;/h3&gt;
&lt;p&gt;Se supone que cuando dejamos un comentario lo hacemos para suplir alguna
carencia que tenemos en el código así que primer consejo, &lt;strong&gt;no maquilles mal
código con comentarios&lt;/strong&gt;. Si unas líneas de tu código no hacen lo que dicen,
no están nombradas como deberían o no tienen sentido que estén ahí, no les
añadas un comentario aclaratorio no es la solución.&lt;/p&gt;</description>
    </item>
  </channel>
</rss>
