Szerkesztési folyamat

Miért publikáljuk ezt#

Az IPFS.NINJA blog azért létezik, hogy segítsen a fejlesztőknek megalapozott döntéseket hozni a tartalom-alapú (content-addressed) tárolással kapcsolatban — melyik pinning szolgáltatást érdemes használni, mikor éri meg egy dedikált gateway, hogyan kell valójában pinelni az NFT metaadatokat, és így tovább. Ezeknek a döntéseknek mindegyike valós költség- és lock-in vonzattal jár. Ezért komolyan vesszük az általunk publikált tartalom pontosságát, és úgy gondoljuk, pontosan tudnod kell, hogyan készül a tartalom ezen a blogon.

Mi különbözteti meg a tartalmunkat#

• Termékkel ellenőrizve. Minden kódpélda, API-hívás és árazási adat ellenőrzésre kerül az éles IPFS.NINJA platformmal szemben a megírás idején. Ha egy állítás nem tesztelhető az éles rendszeren, nem publikáljuk.
• Üzemeltetők írják, nem marketingesek. Az, aki átnézi az egyes bejegyzéseket, napról napra üzemelteti is a platformot, kezeli a support ticketeket, és olvassa az általa kibocsátott üzemeltetési jelzéseket.
• Az összehasonlítások őszinték. Amikor azt írjuk, hogy „IPFS.NINJA vs. Pinata / Filebase / Web3.Storage”, szó szerint hivatkozunk a nyilvános dokumentációjukra és árazási oldalaikra. Semmit nem torzítunk el. Ha ők vezettek be valamit, amit mi még nem, azt is elmondjuk.
• AI-asszisztált, emberi felelősséggel. Minden cikket egy néven nevezett ember hagy jóvá publikálás előtt. Az AI a léptékben segít; az emberi ítélőképesség dönt a megjelenésről.

Hogyan készül minden cikk#

1. Brief létrehozása#

Minden cikk egy valós jelzésből indul ki — egy support ticket mintázatból, egy Search Console keresési kifejezés-klaszterből, vagy egy ügyfél integrációs kérdéséből. A brief rögzíti a célközönséget, a cikk ígéretét, és azt a keresési szándékot, amelyet megcéloz.

2. Kutatás és termékellenőrzés#

Minden állításhoz elolvassuk az elsődleges forrásokat: az IPFS specifikációt, a go-ipfs / kubo dokumentációt, a versenytársak aktuális árazását és API-dokumentációját. Minden kódrészletet lefuttatunk az éles IPFS.NINJA platformon. Ha valami nem úgy működik, ahogy dokumentálva van, azt termékhibaként rögzítjük, mielőtt publikálnánk a cikket.

3. Megírás#

A legtöbb vázlat AI segítségével készül, egy olyan tartalomgeneráló prompt alapján, amely tartalmazza a cikk briefjét, a 2. lépésben ellenőrzött tényeket, és a stílusútmutatónkat. A vázlatok teljes frontmatterrel ellátott .md fájlként kerülnek a repóba, ellenőrzésre készen — nincs marketingsablon, nincs külön CMS.

4. Emberi ellenőrzés#

Egy néven nevezett szerkesztő elejétől a végéig elolvassa az összes vázlatot. A feladata, hogy kiszűrje a következőket:

• Bármely állítást, amelyet az elsődleges források nem támasztanak alá, vagy amely nem reprodukálható az éles terméken
• Olyan összehasonlításokat, amelyek túlzóan pozitív színben tüntetik fel a mi pozíciónkat, vagy félreértelmezik egy versenytárs aktuális kínálatát
• Olyan tanácsokat, amelyek valódi pénzébe kerülnének az olvasónak, ha megfogadná őket — árazási számítások, csomagválasztás, migrációs útvonalak
• Olyan szöveget, amely inkább marketingnek hat, mint gyakorlati mérnöki tartalomnak

5. Finomítás és végső átolvasás#

A szerkesztő észrevételei módosításokként térnek vissza, amelyeket az AI alkalmaz az eredeti vázlatra a szerkesztő konkrét visszajelzései alapján. A szerkesztő ezután elolvassa a módosított verziót, hogy megerősítse: minden észrevételt valóban kezeltek — nem csak tudomásul vettek.

6. Lokalizáció#

Minden publikálásra kész cikket lefordítunk további 40 nyelvi verzióra. Minden fordítás megőrzi az eredeti technikai pontosságát — a kódpéldák nem íródnak újra, csak a szöveg kerül lokalizálásra. Az angol cikk mindig irányadó; ha egy lefordított verzió eltér az angoltól, az angol az érvényes.

7. Publikálás és AI-közzététel#

Minden publikált cikk tartalmaz egy jól látható AI-tartalom közzétételt (minden bejegyzés alján), amely elmagyarázza, hogy a cikk AI-asszisztált volt és emberi ellenőrzésen esett át. Ez egyszerre Google hasznos-tartalom jelzés, és egy ígéret az olvasó felé, hogy az olvasott tartalom eredete nincs elrejtve.

A tartalom frissen tartása#

Az IPFS és ökoszisztémája gyorsan fejlődik. Az árak változnak. Az API-k elavulnak. A bevált gyakorlatok fejlődnek. Egy tartalom, amely a megjelenésekor pontos volt, egy évvel később félrevezetővé válhat.

Minden héten futtatunk egy automatizált SEO- és frissesség-követő eszközt a teljes tartalomkészleten. Ez lekéri a Search Console jelzéseit, oldalankénti on-page auditot végez, és azonosítja azokat a bejegyzéseket, amelyek elavult keresésekre rangsorolnak, vagy elavult API-kra hivatkoznak. Az eredmény egy konkrét szerkesztési feladatlista lesz — többnyire mechanikus (egy elavult ár javítása, egy elavult végpont lecserélése), néhány pedig emberi mérlegelést igényel (hogy egy cikknek érdemi átírásra van-e szüksége, vagy inkább visszavonásra).

Minden bejegyzés tartalmaz egy Frissítve: dátumot a fejlécben, amely eltér az eredeti publikálási dátumtól, hogy tudd, mennyire friss az előtted lévő tartalom valójában.

Szerkesztési alapelveink#

Termékpontosság a sebesség helyett#

Inkább publikálunk egy pontos, ellenőrzött cikket hetente, mint négyet, amelyek csak felszínesen érintik a témát. Ha egy állítás nem támasztható alá az éles terméken, nem publikáljuk. Ennyi.

Néven nevezett emberek ellenőriznek mindent#

Minden cikk szerkesztői ellenőrzését egy konkrét, néven nevezett személy végzi — lásd bármelyik bejegyzés szerzői sorát. Nem publikálunk névtelenül, és nem bújunk el egy intézményi hang mögé.

A lokalizáció tiszteletben tartja a forrást#

A fordítások megőrzik az angol eredeti technikai tényeit. A nyelvspecifikus szöveg, írásjelek és nyelvi fordulatok igazodnak a célnyelvhez; az alapul szolgáló állítások nem változnak.

Az összehasonlítások elsődleges forrásokra hivatkoznak#

Minden versenytárssal kapcsolatos állítás a versenytárs saját, aktuális dokumentációjára vagy árazási oldalára linkel. Ha egy versenytárs kínálata megváltozott azóta, hogy írtunk róla, kijavítjuk a cikket — nem hagyunk elavult összehasonlításokat érvényben.

A gyakorlatiasság a szellemesség helyett#

Arra optimalizálunk, hogy a cikk segít-e egy valódi fejlesztőnek valódi döntést hozni — nem arra, hogy mennyire szellemes a megfogalmazás, vagy mennyire újszerű a nézőpont.

Átláthatóság az AI-val kapcsolatban#

Minden AI-asszisztált cikk ezt jelzi, a bejegyzés alján, minden nyelvi verzióban, minden publikációnál. Nincs kertelés, nincs marketinges csomagolás.

Az elköteleződésünk#

Ha bármit találsz ezen a blogon, ami ténybelileg helytelen, elavult, vagy félreértelmezi egy versenytárs termékét, szeretnénk tudni róla. Vedd fel velünk a kapcsolatot a hello@ipfs.ninja címen. Nyíltan javítjuk a cikkeket — minden érdemi módosítás frissíti a Frissítve: dátumot, és megőrzi az auditnyomot a Git history-ban.

A bizalom az egész lényege annak, hogy egyáltalán a tartalom-alapú tárolásról írunk. Mi magunkkal szemben is ugyanezt a mércét alkalmazzuk.