Redakčný proces

Prečo toto publikujeme#

Blog IPFS.NINJA existuje preto, aby pomohol vývojárom robiť rozumné rozhodnutia o ukladaní dát adresovanom podľa obsahu (content-addressed storage) — ktorú pinning službu použiť, kedy sa oplatí vyhradená brána, ako by sa v skutočnosti mali pripájať metadáta NFT a podobne. Každé z týchto rozhodnutí má reálne nákladové dôsledky a dôsledky viazanosti na dodávateľa (lock-in). Preto berieme presnosť toho, čo publikujeme, vážne a myslíme si, že by ste mali presne vedieť, ako obsah na tomto blogu vzniká.

Čím sa náš obsah odlišuje#

• Overené voči produktu. Každá ukážka kódu, volanie API a cenový údaj sa pri písaní overuje voči živej platforme IPFS.NINJA. Ak sa tvrdenie nedá otestovať voči produkcii, nepublikujeme ho.
• Píšu ho prevádzkovatelia, nie marketéri. Osoba, ktorá kontroluje každý príspevok, zároveň platformu bežne prevádzkuje, rieši podporné tikety a sleduje prevádzkové signály, ktoré platforma generuje.
• Porovnania sú čestné. Keď píšeme „IPFS.NINJA vs. Pinata / Filebase / Web3.Storage“, citujeme doslovne ich verejnú dokumentáciu a cenníky. Nič nezľahčujeme ani neskresľujeme. Ak priniesli niečo, čo my nemáme, priznáme to.
• S pomocou AI, no pod ľudskou zodpovednosťou. Každý článok pred publikovaním schvaľuje konkrétny menovaný človek. AI pomáha so škálovaním; o publikovaní rozhoduje ľudský úsudok.

Ako vzniká každý článok#

1. Vytvorenie zadania#

Každý článok vzniká z reálneho signálu — vzorca v podporných tiketoch, klastra dopytov zo Search Console alebo otázky pri integrácii od zákazníka. Zadanie zachytáva cieľové publikum, prísľub, ktorý článok dáva, a vyhľadávací zámer, na ktorý cieli.

2. Výskum a overenie na produkte#

Čítame primárne zdroje pre každé tvrdenie: špecifikáciu IPFS, dokumentáciu go-ipfs / kubo, aktuálne ceny a API dokumentáciu konkurencie. Každý úryvok kódu spúšťame voči živej platforme IPFS.NINJA. Ak niečo nefunguje tak, ako je zdokumentované, nahlásime to ako chybu produktu ešte pred publikovaním článku.

3. Písanie návrhu#

Väčšinu návrhov vytvárame s pomocou AI podľa promptu na generovanie obsahu, ktorý obsahuje zadanie článku, overené fakty z kroku 2 a náš štýlový manuál. Návrhy pristávajú v repozitári ako súbor .md s kompletným frontmatterom, pripravené na kontrolu — bez marketingovej šablóny, bez samostatného CMS.

4. Ľudská kontrola#

Menovaný recenzent prečíta každý návrh od začiatku do konca. Jeho úlohou je odhaliť:

• Akékoľvek tvrdenie, ktoré nie je podložené primárnymi zdrojmi alebo sa nedá reprodukovať na živom produkte
• Porovnania, ktoré nadhodnocujú našu pozíciu alebo skresľujú aktuálnu ponuku konkurencie
• Rady, ktoré by čitateľa stáli reálne peniaze, ak by sa nimi riadil — výpočty cien, výber tarify, migračné postupy
• Text, ktorý pôsobí ako marketing namiesto praktického inžinierskeho obsahu

5. Dopracovanie a záverečné čítanie#

Pripomienky recenzenta sa vracajú ako úpravy, ktoré vykonáva AI na základe pôvodného návrhu a konkrétnej spätnej väzby recenzenta. Recenzent potom prečíta upravenú verziu, aby potvrdil, že každá pripomienka bola skutočne vyriešená — nielen zaznamenaná.

6. Lokalizácia#

Každý článok pripravený na publikovanie prekladáme do 40 ďalších lokalít. Každý preklad zachováva technickú presnosť originálu — kód v ukážkach sa neprepisuje, lokalizuje sa iba text. Anglický článok je vždy záväzný (kanonický); ak sa preložená verzia rozchádza s angličtinou, platí angličtina.

7. Publikovanie a zverejnenie o AI#

Každý publikovaný článok obsahuje viditeľné zverejnenie o AI obsahu (v spodnej časti každého príspevku), ktoré vysvetľuje, že článok vznikol s pomocou AI a prešiel ľudskou kontrolou. Je to signál v zmysle Google helpful-content a zároveň prísľub čitateľovi, že pôvod toho, čo číta, nie je skrytý.

Udržiavanie obsahu aktuálnym#

IPFS a jeho ekosystém sa vyvíjajú rýchlo. Ceny sa menia. API sa zastarávajú. Osvedčené postupy sa vyvíjajú. Obsah, ktorý bol presný v čase publikovania, môže byť o rok zavádzajúci.

Nad celým archívom obsahu spúšťame každý týždeň automatizovaný nástroj na sledovanie SEO a aktuálnosti. Ten sťahuje signály zo Search Console, robí audit jednotlivých stránok priamo na obsahu a identifikuje príspevky, ktoré sa umiestňujú na zastarané dopyty alebo odkazujú na zastarané API. Výsledkom je zoznam konkrétnych úprav — väčšinou mechanických (oprava zastaranej ceny, nahradenie zastaraného endpointu), niektoré si vyžadujú ľudské posúdenie (či článok potrebuje zásadné prepísanie, alebo ho treba stiahnuť).

Každý príspevok má v hero sekcii dátum Aktualizované:, odlišný od dátumu pôvodného publikovania, aby ste vedeli, aký aktuálny je obsah pred vami.

Naše redakčné princípy#

Presnosť pred rýchlosťou#

Radšej publikujeme jeden presný, overený článok týždenne než štyri články, ktoré tému len povrchne obídu. Ak sa tvrdenie nedá podložiť na živom produkte, nepublikujeme ho. Bodka.

Menovaní ľudia kontrolujú všetko#

Redakčnú kontrolu každého článku vykonáva konkrétny, menovaný človek — pozrite si autorstvo pri ktoromkoľvek príspevku. Nepublikujeme anonymne a neschovávame sa za inštitucionálny hlas.

Lokalizácia rešpektuje zdroj#

Preklady zachovávajú technické fakty anglického originálu. Prispôsobujú sa jazykovo špecifický text, interpunkcia a idiómy; samotné tvrdenia sa nemenia.

Porovnania citujú primárne zdroje#

Každé tvrdenie o konkurencii odkazuje na jej vlastnú aktuálnu dokumentáciu alebo cenník. Ak sa ponuka konkurencie od napísania článku zmenila, článok opravíme — zastarané porovnania nenechávame bez povšimnutia.

Praktickosť pred dôvtipom#

Optimalizujeme na to, či článok pomôže reálnemu vývojárovi urobiť reálne rozhodnutie — nie na to, aké dôvtipné je podanie alebo aké originálne je uchopenie témy.

Transparentnosť ohľadom AI#

Každý článok vytvorený s pomocou AI to uvádza, na konci, v každej lokalite, pri každom publikovaní. Bez zahmlievania, bez marketingového rámovania.

Náš záväzok#

Ak na tomto blogu nájdete niečo vecne nesprávne, zastarané alebo skresľujúce produkt konkurencie, chceme o tom vedieť. Ozvite sa nám na hello@ipfs.ninja. Články opravujeme otvorene — každá zásadná úprava posúva dátum Aktualizované: a zachováva záznam v histórii Gitu.

Dôvera je celý zmysel písania o ukladaní dát adresovanom podľa obsahu. Kladieme na seba rovnaký štandard.