Redakcionālais process

Kāpēc mēs to publicējam#

IPFS.NINJA emuārs pastāv, lai palīdzētu izstrādātājiem pieņemt pamatotus lēmumus par satura adresējamu krātuvi — kuru piespraušanas pakalpojumu izmantot, kad ir vērts izmantot dedicētu vārteju, kā patiesībā vajadzētu piespraust NFT metadatus, un tā tālāk. Katram no šiem lēmumiem ir reālas izmaksu un piesaistes (lock-in) sekas. Tāpēc mēs nopietni izturamies pret to, ko publicējam, un uzskatām, ka jums būtu jāzina, kā tieši šī emuāra saturs top.

Kas atšķir mūsu saturu#

• Pārbaudīts ar produktu. Katrs koda piemērs, API izsaukums un cenu rādītājs melnraksta izveides laikā tiek pārbaudīts pret reālo IPFS.NINJA platformu. Ja apgalvojumu nevar pārbaudīt pret ražošanas vidi, tas netiek publicēts.
• Rakstīts operatoru, nevis mārketinga speciālistu, skatījumā. Persona, kas pārskata katru rakstu, arī ikdienā vada platformu, apstrādā atbalsta pieprasījumus un seko līdzi tās darbības rādītājiem.
• Salīdzinājumi ir godīgi. Rakstot “IPFS.NINJA vs. Pinata / Filebase / Web3.Storage”, mēs citējam viņu publisko dokumentāciju un cenu lapas burtiski. Nekas netiek sagrozīts vai vājināts. Ja viņi ir ieviesuši kaut ko, kā mums nav, mēs to atklāti pasakām.
• MI atbalstīts, cilvēka pārziņā. Katru rakstu pirms publicēšanas apstiprina konkrēts, vārdā zināms cilvēks. MI palīdz nodrošināt apjomu; cilvēka spriedums lemj par publicēšanu.

Kā top katrs raksts#

1. Uzdevuma izveide#

Katrs raksts sākas ar reālu signālu — atbalsta pieprasījumu modeli, Search Console vaicājumu kopu vai klienta integrācijas jautājumu. Uzdevuma apraksts (brief) fiksē mērķauditoriju, solījumu, ko raksts dod, un meklēšanas nolūku, uz kuru tas mērķēts.

2. Izpēte un produkta pārbaude#

Mēs katram apgalvojumam lasām primāros avotus: IPFS specifikāciju, go-ipfs / kubo dokumentāciju, konkurentu aktuālās cenas un API dokumentāciju. Katrs koda fragments tiek izpildīts pret reālo IPFS.NINJA platformu. Ja kaut kas nedarbojas tā, kā dokumentēts, mēs to pirms raksta publicēšanas reģistrējam kā produkta kļūdu.

3. Melnraksta sagatavošana#

Lielākā daļa melnrakstu tiek sagatavoti ar MI palīdzību, izmantojot satura ģenerēšanas uzvedni, kas ietver raksta uzdevumu, 2. solī pārbaudītos faktus un mūsu balss vadlīnijas. Melnraksti nonāk repozitorijā kā .md fails ar pilnu titullapas informāciju (frontmatter), gatavs pārskatīšanai — bez mārketinga veidnes, bez atsevišķas CMS.

4. Cilvēka veikta pārskatīšana#

Konkrēts, vārdā zināms recenzents izlasa katru melnrakstu no sākuma līdz beigām. Viņa uzdevums ir pamanīt:

• Jebkuru apgalvojumu, kuru neapstiprina primārie avoti vai kuru neizdodas atkārtot uz reālā produkta
• Salīdzinājumus, kas pārspīlē mūsu pozīciju vai nepareizi atspoguļo konkurenta pašreizējo piedāvājumu
• Ieteikumus, kas lasītājam varētu izmaksāt reālu naudu, ja tas tos ievērotu, — cenu aprēķinus, plāna izvēli, migrācijas ceļus
• Tekstu, kas izklausās pēc mārketinga, nevis praktiskas inženierijas

5. Uzlabošana un gala pārbaude#

Recenzenta atzīmētās problēmas atgriežas kā labojumi, kurus MI piemēro sākotnējam melnrakstam kopā ar recenzenta konkrētajām piezīmēm. Pēc tam recenzents izlasa labojumu, lai pārliecinātos, ka katra atzīmētā problēma ir tiešām atrisināta — ne tikai atzīmēta kā zināma.

6. Lokalizācija#

Mēs tulkojam katru publicēšanai gatavu rakstu vēl 40 lokalizācijās. Katrs tulkojums saglabā oriģināla tehnisko precizitāti — koda piemēri netiek pārrakstīti, tiek lokalizēts tikai teksts. Angļu valodas raksts vienmēr ir kanoniskais; ja tulkotā versija atšķiras no angļu valodas versijas, noteicošā ir angļu valoda.

7. Publicēšana un MI atklāsme#

Katram publicētajam rakstam ir redzama MI satura atklāsme (katra raksta apakšā), kas paskaidro, ka rakstu ir palīdzējis sagatavot MI un pārskatījis cilvēks. Tas ir Google noderīgā satura signāls un solījums lasītājam, ka lasāmā satura izcelsme netiek slēpta.

Satura aktualitātes uzturēšana#

IPFS un tā ekosistēma attīstās strauji. Cenas mainās. API tiek novecinātas. Labākā prakse mainās. Saturs, kas bija precīzs publicēšanas brīdī, gada laikā var kļūt maldinošs.

Mēs katru nedēļu visam saturam palaižam automatizētu SEO un aktualitātes pārbaudi. Tā apkopo Search Console signālus, veic lapas satura auditu un identificē rakstus, kas ranžējas pēc novecojušiem vaicājumiem vai atsaucas uz novecinātām API. Rezultāts kļūst par konkrētu labojumu darba sarakstu — lielākoties mehānisku (novecojušas cenas labošana, novecinātas galapunkta aizstāšana), dažus lēmumus pieņem cilvēks (vai rakstam nepieciešams būtisks pārraksts, vai tas jāizņem no publikācijas).

Katram rakstam varoņa (hero) daļā ir Atjaunināts: datums, kas atšķiras no sākotnējās publicēšanas datuma, lai jūs zinātu, cik aktuāls patiesībā ir jums priekšā esošais saturs.

Mūsu redakcionālie principi#

Produkta precizitāte pirms ātruma#

Mēs labāk publicēsim vienu precīzu, pārbaudītu rakstu nedēļā, nekā četrus rakstus, kas tēmu aptver virspusēji. Ja apgalvojumu nevar apstiprināt pret reālo produktu, tas netiek publicēts. Bez izņēmumiem.

Vārdā zināmi cilvēki pārskata visu#

Katra raksta redakcionālo pārskatīšanu veic konkrēta, vārdā zināma persona — skatiet jebkura raksta autora norādi. Mēs nepublicējam anonīmi un neslēpjamies aiz institucionālas balss.

Lokalizācija respektē avotu#

Tulkojumi saglabā angļu valodas oriģināla tehniskos faktus. Konkrētajai valodai raksturīgais teksts, pieturzīmes un izteiksmes veids tiek pielāgoti; pamatā esošie apgalvojumi netiek mainīti.

Salīdzinājumi atsaucas uz primārajiem avotiem#

Katrs apgalvojums par konkurentu satur saiti uz paša konkurenta pašreizējo dokumentāciju vai cenu lapu. Ja konkurenta piedāvājums kopš raksta uzrakstīšanas ir mainījies, mēs rakstu izlabojam — mēs neatstājam novecojušus salīdzinājumus spēkā.

Praktiskums pirms atjautības#

Mēs koncentrējamies uz to, vai raksts palīdz reālam izstrādātājam pieņemt reālu lēmumu — nevis uz to, cik atjautīgs ir pasniegšanas veids vai cik novatorisks ir skatījums.

Caurskatāmība par MI izmantošanu#

Katrs raksts, kura tapšanā palīdzējis MI, to atklāj raksta apakšā, katrā lokalizācijā, katrā publikācijā. Bez izvairīšanās, bez mārketinga piegaršas.

Mūsu apņemšanās#

Ja šajā emuārā pamanāt kaut ko faktoloģiski nepareizu, novecojušu vai tādu, kas nepareizi atspoguļo konkurenta produktu, mēs vēlamies par to zināt. Sazinieties ar mums, rakstot uz hello@ipfs.ninja. Mēs rakstus labojam atklāti — katrs būtisks labojums atjaunina Atjaunināts: datumu un saglabā izmaiņu vēsturi Git.

Uzticēšanās ir viss iemesls, kāpēc vispār rakstām par satura adresējamu krātuvi. Mēs pret sevi izvirzām tieši tādu pašu standartu.