Procés editorial

Per què publiquem això#

El blog d’IPFS.NINJA existeix per ajudar els desenvolupadors a prendre bones decisions sobre l’emmagatzematge adreçat per contingut: quin servei de pinning fer servir, quan val la pena un gateway dedicat, com s’ha de fer el pin de les metadades d’un NFT, etcètera. Cadascuna d’aquestes decisions té implicacions reals de cost i de dependència del proveïdor (lock-in). Per això ens prenem seriosament l’exactitud del que publiquem, i creiem que has de saber exactament com es fa el contingut d’aquest blog.

Què diferencia el nostre contingut#

• Verificat amb el producte. Cada mostra de codi, crida a l’API i xifra de preu es comprova contra la plataforma d’IPFS.NINJA en producció en el moment de redactar l’esborrany. Si una afirmació no es pot provar contra producció, no es publica.
• Escrit per operadors, no per màrqueting. La persona que revisa cada article també gestiona la plataforma dia a dia, atén els tiquets de suport i llegeix els senyals operatius que genera.
• Les comparatives són honestes. Quan escrivim «IPFS.NINJA vs. Pinata / Filebase / Web3.Storage» citem textualment la seva documentació pública i les seves pàgines de preus. No fem servir arguments de palla. Si han llançat alguna cosa que nosaltres no tenim, ho diem.
• Assistit per IA, propietat humana. Una persona identificada aprova cada article abans de publicar-lo. La IA ajuda a escalar; el criteri humà és qui decideix la publicació.

Com es fa cada article#

1. Creació del brief#

Cada article parteix d’un senyal real: un patró de tiquets de suport, un clúster de consultes de Search Console o una pregunta d’integració d’un client. El brief recull el públic objectiu, la promesa que fa l’article i la intenció de cerca a la qual s’adreça.

2. Recerca i verificació amb el producte#

Llegim les fonts primàries de cada afirmació: l’especificació d’IPFS, la documentació de go-ipfs / kubo, i els preus i la documentació de l’API actuals dels competidors. Cada fragment de codi s’executa contra la plataforma d’IPFS.NINJA en producció. Si alguna cosa no funciona tal com està documentada, l’obrim com a error del producte abans de publicar l’article.

3. Redacció#

La majoria d’esborranys es produeixen amb l’ajuda d’IA mitjançant un prompt de generació de contingut que incorpora el brief de l’article, els fets verificats del pas 2 i la nostra guia de veu. Els esborranys arriben al repositori com a fitxer .md amb el frontmatter complet, llestos per revisar-se — sense plantilla de màrqueting, sense CMS separat.

4. Revisió humana#

Una persona revisora identificada llegeix cada esborrany d’extrem a extrem. La seva feina és detectar:

• Qualsevol afirmació que no estigui recolzada per les fonts primàries o que no es reprodueixi contra el producte en producció
• Comparatives que exagerin la nostra posició o tergiversin l’oferta actual d’un competidor
• Consells que costarien diners reals al lector si els seguís: càlculs de preus, selecció de plans, camins de migració
• Text que soni a màrqueting en lloc d’enginyeria pràctica

5. Refinament i lectura final#

Els avisos de la persona revisora tornen com a revisions, aplicades per la IA sobre l’esborrany original més el feedback específic de la revisió. Tot seguit, la persona revisora llegeix la revisió per confirmar que cada avís s’ha resolt — no només reconegut.

6. Localització#

Traduïm cada article llest per publicar a 40 idiomes addicionals. Cada traducció preserva l’exactitud tècnica de l’original — les mostres de codi no es reescriuen, només es localitza el text. L’article en anglès sempre és la versió canònica; si una variant traduïda difereix de l’anglès, preval l’anglès.

7. Publicació i divulgació de la IA#

Cada article publicat porta una declaració visible de divulgació de contingut generat amb IA (a la part inferior de cada article) que explica que l’article ha estat assistit per IA i revisat per humans. Això és un senyal de contingut útil de Google i una promesa al lector que la procedència del que llegeix no s’amaga.

Mantenir el contingut actualitzat#

IPFS i el seu ecosistema evolucionen ràpidament. Els preus canvien. Les API queden obsoletes. Les bones pràctiques evolucionen. Contingut que era exacte quan es va publicar pot esdevenir enganyós un any després.

Executem un rastrejador automatitzat de SEO i frescor sobre tot el corpus cada setmana. Extreu senyals de Search Console, fa una auditoria on-page per a cada pàgina i identifica articles que estan posicionant per a consultes obsoletes o que fan referència a API obsoletes. El resultat esdevé una llista de tasques d’edicions concretes — la majoria mecàniques (corregir un preu desactualitzat, substituir un endpoint obsolet), algunes amb criteri humà (si un article necessita una reescriptura substancial o retirar-lo).

Cada article porta una data d’Actualitzat: a la capçalera, diferent de la data de publicació original, perquè sàpigues com de fresc és realment el contingut que tens davant.

Els nostres principis editorials#

L’exactitud del producte per davant de la velocitat#

Preferim publicar un article exacte i verificat per setmana que quatre articles que només toquin un tema per sobre. Si una afirmació no es pot recolzar contra el producte en producció, no es publica. Punt.

Persones identificades ho revisen tot#

La revisió editorial de cada article la fa una persona específica i identificada — consulta la signatura de qualsevol article. No publiquem de manera anònima ni ens amaguem darrere d’una veu institucional.

La localització respecta la font#

Les traduccions preserven els fets tècnics de l’original en anglès. El text, la puntuació i les expressions idiomàtiques s’adapten a cada idioma; les afirmacions de fons no.

Les comparatives citen fonts primàries#

Cada afirmació sobre un competidor enllaça a la seva pròpia documentació o pàgina de preus actual. Si l’oferta d’un competidor ha canviat des que en vam escriure, corregim l’article — no deixem comparatives desactualitzades.

Pràctic per davant d’enginyós#

Optimitzem perquè l’article ajudi un desenvolupador real a prendre una decisió real — no perquè l’enfocament sigui enginyós o el punt de vista sigui original.

Transparents sobre la IA#

Cada article assistit per IA ho indica, a la part inferior, en cada idioma, a cada publicació. Sense evasives, sense enfocament de màrqueting.

El nostre compromís#

Si trobes en aquest blog alguna cosa que sigui factualment incorrecta, desactualitzada o que tergiversi el producte d’un competidor, volem saber-ho. Contacta’ns a hello@ipfs.ninja. Corregim els articles de manera oberta — cada edició substancial actualitza la data d’Actualitzat: i preserva un registre d’auditoria a l’historial de Git.

La confiança és tota la raó de ser d’escriure sobre l’emmagatzematge adreçat per contingut. Ens exigim el mateix estàndard a nosaltres mateixos.