Proceso editorial

Por qué publicamos esto#

El blog de IPFS.NINJA existe para ayudar a los desarrolladores a tomar buenas decisiones sobre almacenamiento con direccionamiento por contenido — qué servicio de pinning usar, cuándo merece la pena un gateway dedicado, cómo debería anclarse 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 ejemplo de código, cada llamada a la API y cada cifra de precio se comprueba contra la plataforma de IPFS.NINJA en producción en el momento de redactar el borrador. Si una afirmación no se puede comprobar en producción, no se publica.
• Escrito por operadores, no por comerciales. La persona que revisa cada artículo también gestiona 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 frente a Pinata / Filebase / Web3.Storage», citamos textualmente sus páginas públicas de documentación y precios. Nada se tergiversa. Si han lanzado algo que nosotros no tenemos, lo decimos.
• Asistido por IA, propiedad humana. Una persona identificada aprueba cada artículo antes de publicarlo. La IA ayuda a escalar; el criterio humano da el visto bueno final.

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 grupo 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 se dirige.

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 actuales de la API de los competidores. Cada fragmento de código se ejecuta contra la plataforma de IPFS.NINJA en producción. Si algo no funciona como está documentado, lo registramos como un fallo del producto antes de publicar el artículo.

3. Redacción#

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

4. Revisión humana#

Una persona identificada 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 en el producto en producción.
• 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.
• Texto que suene a marketing en lugar de a ingeniería práctica.

5. Refinamiento y lectura final#

Las observaciones del revisor vuelven como revisiones, aplicadas por la 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 se ha resuelto — no solo reconocido.

6. Localización#

Traducimos cada artículo listo para publicar a 40 idiomas adicionales. Cada traducción conserva la exactitud técnica del original — los ejemplos de código no se reescriben, solo se localiza el texto. El artículo en inglés es siempre la versión canónica; si una variante traducida difiere del inglés, prevalece el inglés.

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

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

Cómo mantenemos el contenido actualizado#

IPFS y su ecosistema avanzan rápido. Los precios cambian. Las API se 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 actualidad sobre todo el corpus cada semana. Extrae señales de Search Console, hace una auditoría en página de cada artículo e identifica los que están posicionando para consultas obsoletas o que hacen referencia a API ya descontinuadas. El resultado se convierte en una lista de tareas concretas — en su mayoría mecánicas (corregir un precio desactualizado, sustituir un endpoint obsoleto) y algunas que requieren criterio humano (si un artículo necesita una reescritura sustancial o retirarse).

Cada artículo lleva una fecha de Actualizado: en la cabecera, distinta de su fecha de publicación original, para que sepas de primera mano cuán reciente es el contenido que tienes delante.

Nuestros principios editoriales#

La exactitud del producto por encima de la velocidad#

Preferimos publicar un artículo preciso y verificado a la semana que cuatro artículos que solo rozan el tema. Si una afirmación no se puede respaldar contra el producto en producción, no se publica. Punto.

Personas identificadas revisan todo#

La revisión editorial de cada artículo la realiza una persona concreta e identificada — consulta la firma de cualquier entrada. No publicamos de forma anónima ni nos escondemos detrás de una voz institucional.

La localización respeta la fuente#

Las traducciones conservan los hechos técnicos del original en inglés. El texto, la puntuación y los modismos se adaptan a cada idioma; 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 vigente. 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 que resulte el enfoque ni lo novedoso del planteamiento.

Transparencia sobre la IA#

Cada artículo asistido por IA lo indica, al final, en todos los idiomas y en todas las publicaciones. Sin rodeos ni enfoque de marketing.

Nuestro compromiso#

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

La confianza es, en definitiva, la razón de ser de escribir sobre almacenamiento con direccionamiento por contenido. Nos exigimos a nosotros mismos el mismo estándar.