El sitio

Cómo se hace este manual

El sitio sostiene que en esta materia importa más saber cuándo se revisó algo que lo bien escrito que esté. Esta página es la contraparte de esa afirmación: qué se hace con cada entrada, qué significa cada estado y qué pasa cuando un dato deja de ser cierto.

Los tres estados, y qué prometen

Cada entrada lleva un estado a la vista, arriba del texto y en el índice. No es una etiqueta de avance interno: es lo que el sitio se compromete a haber hecho con ese texto antes de publicarlo.

En línea89

Escrita, revisada y firmada. Alguien responde por cada dato que contiene.

Es el estado normal de todo lo que se publica: el esquema del sitio no deja publicar una entrada sin firma.

Pendiente0

Le falta algo y se sabe qué: un apartado, un dato, un ejemplo.

Queda visible y lo declara en su propia página. Una entrada incompleta escondida no se termina nunca.

Planificada1

Está en el plan del manual y todavía no se escribió una línea.

No tiene página: figura en el índice como lo que falta. Publicar setenta páginas vacías para llenar un sitemap es exactamente lo que este manual desaconseja.

Quién firma

Las 89 entradas publicadas llevan la firma de Sebastián Cardozo, con nombre, apellido, rol y una página propia donde se puede ver quién es y cómo contactarlo. No hay entradas firmadas por «el equipo editorial»: si hay un error, hay a quién señalárselo.

La regla no depende de que alguien se acuerde. Está en el esquema del contenido: una entrada sin autor no compila, así que no hay forma de publicar una sin firma ni siquiera por descuido.

Qué se hace al escribir

  • La definición va en la primera oración. Si hacen falta tres párrafos para saber de qué se habla, la entrada está mal escrita y se reescribe. Es la regla que más texto tira a la basura.
  • Los datos van con su fuente y su fecha. Lo que es observación repetida en el oficio y no dato documentado se declara como tal, en lugar de presentarse con el tono de una certeza.
  • Lo que no se sabe se dice. Buena parte de lo que circula sobre motores generativos son conjeturas razonables sobre sistemas cerrados. Cuando algo es una conjetura, la entrada lo nombra así.
  • Firma una persona, no «el equipo». Si hay un error, hay a quién señalárselo.

Qué pasa cuando algo cambia

En este campo una recomendación correcta envejece en un trimestre. Por eso cada entrada lleva un historial de revisiones al final: la fecha de cada cambio de fondo y qué se cambió, no un «actualizado» genérico que no se puede contrastar. Hoy hay 35 entradas con historial, sobre 89 publicadas.

Esa fecha es la que el sitio muestra en el índice, la que viaja en el feed, la que va en el sitemap y la que aparece en la imagen que se ve al compartir el enlace. Sale de un solo lugar, así que no puede decir una cosa en la página y otra en el resto del sitio.

Todos los cambios de todas las entradas, juntos y en orden, están en el registro de cambios. Es la forma de comprobar esto sin tener que creerlo.

Cómo reclamar un error

Si encontrás algo que dejó de ser cierto, o directamente un error, escribí a sebastian@nichoseo.com. Se corrige, se suma la línea al historial de esa entrada con la fecha del día y queda a la vista de cualquiera que la lea después. Una corrección que no se registra no se distingue de no haber corregido nada.

Quién escribe y responde por todo esto está en la página del autor.