Un número de versión que mintió por tres lanzamientos

La página de Código abierto de este sitio lista cuatro paquetes que construí y comparto públicamente, cada uno con una pequeña insignia de versión. v0.6.2, v1.0.0, ese tipo de cosa. Escribí esos números a mano cuando construí la página. Lo que nunca hice fue volver a actualizarlos.

Una revisión señaló el problema obvio: una versión fija en una página pública es una promesa que hay que cumplir manualmente, y nadie cumple esa promesa. Fui a revisar qué tan grave era. Uno de los cuatro mostraba v0.6.2. La versión real publicada, la que cualquiera que la instalara hoy en día realmente obtendría, estaba tres lanzamientos menores por delante. La insignia no solo estaba desactualizada, estaba activamente equivocada, y llevaba así un buen tiempo.

La solución no fue calcularla

Fue eliminarla. Un número de versión en una página de marketing para un paquete de código abierto responde una pregunta que nadie que visita esa página está haciendo. Lo que quieren saber es si el paquete existe, qué hace, y cómo instalarlo. Nada de eso necesita un dígito.

Esa última parte se convirtió en su propia pequeña corrección. Las instrucciones de instalación en cada página de paquete mostraban exactamente la línea de dependencia que este sitio usa internamente, una URL fija de tarball de GitHub, porque así es como este sitio consume sus propios paquetes. Pero ahora estos están publicados en npm, y nadie que esté evaluando si usar uno quiere ver la fontanería privada de este sitio. Quieren el comando que realmente escribirían. Así que el recuadro de instalación ahora muestra un simple npm install, con un enlace real al listado de npm junto al de GitHub.

Lección

“Hacerlo preciso” y “hacerlo útil” no siempre son la misma solución. Podría haber pasado tiempo construyendo un mecanismo para mantener ese número de versión honesto. Lo honesto fue admitir que el número nunca necesitó estar ahí, la conclusión opuesta a la insignia de versión que sí corregí unos días antes, donde el propósito entero de esa página era decir qué corre este sitio.