Esta página
Un registro de cambios, en /changelog y enlazado desde el pie de página. Cada versión y, entre ellas, los cambios que merecen nombrarse — leídos de una sola lista tipada y compuestos por el conversor que vende el producto.
Un registro de cambios solo sirve si uno puede fiarse de lo que no está en él, así que aquí está lo que recibe una entrada.
Qué entra
Cualquier cosa que notaría quien usa TransformPipe: una conversión que antes no existía, una página nueva, otra forma de iniciar sesión, un límite que se movió, un fallo visiblemente equivocado. Una versión etiquetada lleva su número; casi todo lo que ha salido lo hizo entre etiquetas y no lleva ninguno, y por eso la lista es más larga que la lista de versiones.
Qué no
Reescrituras internas, actualizaciones de dependencias, trabajo de compilación e infraestructura: todo lo invisible desde fuera. El aviso de la cabecera de la página lo dice, y esa es la razón para mantenerlo cierto: una entrada sobre un archivo movido convertiría ese aviso en una mentira, y un registro que hay que filtrar es un registro que se deja de leer.
Una sola lista, varios sitios
Cada entrada sale de una única lista tipada del repositorio. La página, los cinco idiomas prerrenderizados, el lastmod del mapa del sitio y el puñado de entradas con página propia la leen todas: no hay un segundo archivo que mantener al día, ni ninguno que olvidar. Los textos son Markdown y los compone el conversor del propio producto: una nota de versión que rompiera el renderizador rompería también el documento de una clienta, y este es mejor sitio para descubrirlo.
En inglés, a propósito
El marco está traducido: el encabezado, la entradilla, el panel de los años y las fechas y los nombres de los meses, que Intl compone en tu idioma. Las entradas mismas no. Cinco traducciones por entrada, por versión, para siempre, es un coste que se abandona después de la segunda versión, y un registro al que le faltan tres idiomas es peor que uno honestamente inglés. Cuando una entrada se ha ganado su propia página, esa página sí puede traducirse: hay un puñado de ellas, no una por versión.
Relacionado: notas de versión escritas en Markdown y documentación que vive en el repositorio.