Proceso editorial

Cómo planificamos, redactamos, revisamos y publicamos cada artículo del blog de IPFS.NINJA. Asistido por IA, revisado por humanos y siempre verificado contra el producto en producción.

Updated

Por qué publicamos esto#

El blog de IPFS.NINJA existe para ayudar a los desarrolladores a tomar buenas decisiones sobre almacenamiento direccionado por contenido: qué servicio de pinning usar, cuándo merece la pena un gateway dedicado, cómo debería pinnearse realmente el metadata de un NFT, y así sucesivamente. Cada una de esas decisiones tiene implicaciones reales de coste y de dependencia del proveedor. Por eso nos tomamos en serio la exactitud de lo que publicamos, y creemos que deberías saber exactamente cómo se elabora el contenido de este blog.

Qué diferencia a nuestro contenido#

  • Verificado contra el producto. Cada muestra de código, llamada a la API y cifra de precio se comprueba contra la plataforma real de IPFS.NINJA en el momento de redactar. Si una afirmación no se puede probar contra producción, no se publica.
  • Escrito por operadores, no por marketing. La persona que revisa cada entrada también opera la plataforma día a día, atiende los tickets de soporte y lee las señales operativas que esta genera.
  • Las comparaciones son honestas. Cuando escribimos “IPFS.NINJA vs. Pinata / Filebase / Web3.Storage” citamos textualmente su documentación pública y sus páginas de precios. Nada se presenta de forma sesgada. Si ellos han lanzado algo que nosotros no, lo decimos.
  • Asistido por IA, con propiedad humana. Un humano identificado aprueba cada artículo antes de publicarlo. La IA ayuda a escalar; el criterio humano decide si se publica.

Cómo se elabora cada artículo#

1. Creación del brief#

Cada artículo parte de una señal real: un patrón de tickets de soporte, un clúster de consultas de Search Console o una pregunta de integración de un cliente. El brief recoge la audiencia, la promesa que hace el artículo y la intención de búsqueda a la que apunta.

2. Investigación y verificación contra el producto#

Leemos las fuentes primarias de cualquier afirmación: la especificación de IPFS, la documentación de go-ipfs / kubo, y los precios y documentación de API actuales de los competidores. Cada fragmento de código se ejecuta contra la plataforma real de IPFS.NINJA. Si algo no funciona como está documentado, lo registramos como un bug de producto antes de publicar el artículo.

3. Redacción#

La mayoría de los borradores se producen con asistencia de IA bajo un prompt de generación de contenido que incorpora el brief del artículo, los hechos verificados del paso 2 y nuestra guía de voz. Los borradores llegan al repositorio como un archivo .md con frontmatter completo, listos para revisión, sin plantilla de marketing ni CMS aparte.

4. Revisión humana#

Un revisor identificado lee cada borrador de principio a fin. Su trabajo es detectar:

  • Cualquier afirmación que no esté respaldada por las fuentes primarias o que no se reproduzca contra el producto real
  • Comparaciones que exageren nuestra posición o tergiversen la oferta actual de un competidor
  • Consejos que le costarían dinero real al lector si los siguiera: cálculos de precios, elección de plan, rutas de migración
  • Textos que suenen a marketing en lugar de ingeniería práctica

5. Refinamiento y lectura final#

Las observaciones del revisor vuelven como revisiones, aplicadas por IA sobre el borrador original más el feedback específico del revisor. El revisor entonces lee la revisión para confirmar que cada observación quedó resuelta, no solo reconocida.

6. Localización#

Traducimos cada artículo listo para publicar a 40 idiomas adicionales. Cada traducción preserva la exactitud técnica del original: las muestras de código no se reescriben, solo se localiza el texto. El artículo en inglés siempre es el canónico; si una variante traducida discrepa del inglés, el inglés prevalece.

7. Publicación y divulgación de IA#

Cada artículo publicado lleva una divulgación visible sobre el uso de IA (al final de cada entrada) explicando que el artículo fue asistido por IA y revisado por humanos. Esto es una señal de contenido útil para Google y una promesa al lector de que la procedencia de lo que está leyendo no está oculta.

Cómo mantenemos el contenido actualizado#

IPFS y su ecosistema evolucionan rápido. Los precios cambian. Las API quedan obsoletas. Las buenas prácticas evolucionan. Un contenido que era exacto cuando se publicó puede volverse engañoso un año después.

Ejecutamos un rastreador automatizado de SEO y frescura sobre todo el corpus cada semana. Extrae señales de Search Console, hace una auditoría en página por cada URL, e identifica entradas que están posicionando para consultas obsoletas o que hacen referencia a API descontinuadas. El resultado se convierte en una lista de trabajo de ediciones concretas —la mayoría mecánicas (corregir un precio desactualizado, sustituir un endpoint obsoleto), algunas a criterio humano (si un artículo necesita una reescritura sustancial o retirarse).

Cada entrada lleva una fecha de Actualizado: en el hero, distinta de su fecha de publicación original, para que sepas cuán reciente es realmente el contenido que tienes delante.

Nuestros principios editoriales#

La exactitud del producto por encima de la velocidad#

Preferimos publicar un artículo exacto y verificado por semana antes que cuatro artículos que apenas rozan un tema. Si una afirmación no se puede respaldar contra el producto real, no se publica. Punto.

Humanos identificados revisan todo#

La revisión editorial de cada artículo la hace una persona concreta e identificada; consulta la firma de cualquier entrada. No publicamos de forma anónima ni nos escondemos tras una voz institucional.

La localización respeta la fuente#

Las traducciones preservan los hechos técnicos del original en inglés. El texto, la puntuación y los modismos propios de cada idioma se ajustan; las afirmaciones subyacentes no.

Las comparaciones citan fuentes primarias#

Cada afirmación sobre un competidor enlaza a su propia documentación o página de precios actual. Si la oferta de un competidor ha cambiado desde que escribimos sobre ella, corregimos el artículo; no dejamos comparaciones desactualizadas.

Lo práctico por encima de lo ingenioso#

Optimizamos para si el artículo ayuda a un desarrollador real a tomar una decisión real, no para lo ingenioso del planteamiento ni lo novedoso del enfoque.

Transparentes sobre la IA#

Todo artículo asistido por IA lo indica, al final, en todos los idiomas, en cada publicación. Sin rodeos, sin enfoque de marketing.

Nuestro compromiso#

Si encuentras algo en este blog que sea factualmente incorrecto, esté desactualizado o tergiverse el producto de un competidor, queremos saberlo. Escríbenos a hello@ipfs.ninja. Corregimos los artículos de forma abierta: cada edición sustancial actualiza la fecha de Actualizado: y preserva un registro de auditoría en el historial de Git.

La confianza es el objetivo mismo de escribir sobre almacenamiento direccionado por contenido. Nos exigimos a nosotros mismos el mismo estándar.

Explorar el blog Sobre nosotros