Processo editoriale

Perché pubblichiamo questo#

Il blog di IPFS.NINJA esiste per aiutare gli sviluppatori a prendere decisioni solide sullo storage a indirizzamento per contenuto — quale servizio di pinning usare, quando conviene un gateway dedicato, come va effettivamente eseguito il pinning dei metadati NFT, e così via. Ognuna di queste decisioni ha implicazioni reali in termini di costi e di lock-in. Per questo prendiamo sul serio l’accuratezza di ciò che pubblichiamo, e pensiamo che tu debba sapere esattamente come vengono creati i contenuti di questo blog.

Cosa distingue i nostri contenuti#

• Verificato sul prodotto. Ogni esempio di codice, chiamata API e cifra di prezzo viene controllata sulla piattaforma live di IPFS.NINJA al momento della stesura. Se un’affermazione non è verificabile in produzione, non viene pubblicata.
• Scritto da operatori, non da marketer. La persona che revisiona ogni articolo è anche chi gestisce la piattaforma giorno per giorno, segue i ticket di supporto e legge i segnali operativi che emette.
• Confronti onesti. Quando scriviamo “IPFS.NINJA vs. Pinata / Filebase / Web3.Storage” citiamo testualmente la loro documentazione pubblica e le loro pagine dei prezzi. Nulla viene travisato. Se hanno rilasciato qualcosa che noi non abbiamo, lo diciamo.
• Assistito dall’IA, di proprietà umana. Una persona identificata per nome approva ogni articolo prima della pubblicazione. L’IA aiuta a scalare; il giudizio umano decide la pubblicazione.

Come nasce ogni articolo#

1. Creazione del brief#

Ogni articolo nasce da un segnale reale — uno schema ricorrente nei ticket di supporto, un cluster di query di Search Console o una domanda di integrazione di un cliente. Il brief definisce il pubblico, la promessa che l’articolo fa e l’intento di ricerca a cui punta.

2. Ricerca e verifica sul prodotto#

Leggiamo le fonti primarie per ogni affermazione: la specifica IPFS, la documentazione di go-ipfs / kubo, i prezzi e la documentazione API attuali dei concorrenti. Ogni snippet di codice viene eseguito sulla piattaforma live di IPFS.NINJA. Se qualcosa non funziona come documentato, lo segnaliamo come bug di prodotto prima di pubblicare l’articolo.

3. Stesura#

La maggior parte delle bozze viene prodotta con l’assistenza dell’IA tramite un prompt di generazione contenuti che include il brief dell’articolo, i fatti verificati al passo 2 e la nostra guida di tono. Le bozze arrivano nel repository come file .md con frontmatter completo, pronte per la revisione — nessun template di marketing, nessun CMS separato.

4. Revisione umana#

Un revisore identificato per nome legge ogni bozza dall’inizio alla fine. Il suo compito è individuare:

• Qualsiasi affermazione non supportata dalle fonti primarie o che non si riproduce sul prodotto live
• Confronti che sopravvalutano la nostra posizione o rappresentano in modo scorretto l’offerta attuale di un concorrente
• Consigli che costerebbero denaro reale al lettore se seguiti — calcoli sui prezzi, scelta del piano, percorsi di migrazione
• Testi che suonano come marketing anziché come ingegneria pratica

5. Rifinitura e lettura finale#

Le segnalazioni del revisore tornano come revisioni, applicate dall’IA alla bozza originale insieme al feedback specifico del revisore. Il revisore legge quindi la nuova versione per confermare che ogni segnalazione sia stata risolta — non solo riconosciuta.

6. Localizzazione#

Traduciamo ogni articolo pronto per la pubblicazione in altre 40 lingue. Ogni traduzione mantiene l’accuratezza tecnica dell’originale — gli esempi di codice non vengono riscritti, solo il testo viene localizzato. L’articolo in inglese è sempre quello canonico; se una versione tradotta è in contraddizione con l’inglese, prevale l’inglese.

7. Pubblicazione e disclosure sull’IA#

Ogni articolo pubblicato riporta una disclosure visibile sui contenuti IA (in fondo a ogni post) che spiega che l’articolo è stato assistito dall’IA e revisionato da una persona. Questo è un segnale per i contenuti utili di Google e una promessa al lettore che la provenienza di ciò che sta leggendo non è nascosta.

Come manteniamo i contenuti aggiornati#

IPFS e il suo ecosistema si evolvono rapidamente. I prezzi cambiano. Le API vengono deprecate. Le best practice si evolvono. Un contenuto accurato al momento della pubblicazione può diventare fuorviante un anno dopo.

Eseguiamo ogni settimana un tracker automatizzato di SEO e aggiornamento su tutto il corpus di contenuti. Raccoglie i segnali di Search Console, esegue un audit on-page per ogni pagina e individua gli articoli che si posizionano per query ormai superate o che fanno riferimento ad API deprecate. Il risultato diventa un elenco di modifiche concrete — per lo più meccaniche (correggere un prezzo obsoleto, sostituire un endpoint deprecato), altre valutate da una persona (se un articolo necessita di una riscrittura sostanziale o del ritiro).

Ogni post riporta una data Aggiornato il: nell’hero, distinta dalla data di pubblicazione originale, così sai quanto è effettivamente aggiornato il contenuto che hai davanti.

I nostri principi editoriali#

Accuratezza del prodotto prima della velocità#

Preferiamo pubblicare un articolo accurato e verificato a settimana piuttosto che quattro articoli che sfiorano appena un argomento. Se un’affermazione non può essere supportata sul prodotto live, non viene pubblicata. Punto.

Persone identificate per nome revisionano tutto#

La revisione editoriale di ogni articolo è svolta da una persona specifica, identificata per nome — vedi la firma di qualsiasi post. Non pubblichiamo in forma anonima e non ci nascondiamo dietro una voce istituzionale.

La localizzazione rispetta la fonte#

Le traduzioni preservano i fatti tecnici dell’originale in inglese. Il testo, la punteggiatura e le espressioni idiomatiche specifiche della lingua vengono adattati; le affermazioni sottostanti no.

I confronti citano fonti primarie#

Ogni affermazione su un concorrente rimanda alla documentazione o alla pagina dei prezzi attuale del concorrente stesso. Se l’offerta di un concorrente è cambiata da quando ne abbiamo scritto, correggiamo l’articolo — non lasciamo confronti obsoleti.

Pratico prima che ingegnoso#

Ottimizziamo per il fatto che l’articolo aiuti davvero uno sviluppatore a prendere una decisione reale — non per quanto sia ingegnosa l’impostazione o originale il punto di vista.

Trasparenza sull’IA#

Ogni articolo assistito dall’IA lo dichiara, in fondo, in ogni lingua, in ogni pubblicazione. Nessuna reticenza, nessuna cornice di marketing.

Il nostro impegno#

Se trovi su questo blog qualcosa di fattualmente errato, obsoleto o che rappresenta in modo scorretto il prodotto di un concorrente, vogliamo saperlo. Contattaci via hello@ipfs.ninja. Correggiamo gli articoli apertamente — ogni modifica sostanziale aggiorna la data Aggiornato il: e mantiene una traccia di controllo nella cronologia Git.

La fiducia è l’intero senso dello scrivere di storage a indirizzamento per contenuto. Applichiamo a noi stessi lo stesso standard.