Proses editorial

Bagaimana kami merancang, merangka, menyemak, dan menerbitkan setiap artikel di blog IPFS.NINJA. Dibantu AI, disemak manusia, dan sentiasa disahkan terhadap produk langsung.

Updated

Kenapa kami menerbitkan ini#

Blog IPFS.NINJA wujud untuk membantu pembangun membuat keputusan storan bercirikan kandungan (content-addressed) yang wajar — perkhidmatan pin mana yang perlu digunakan, bila gateway khusus berbaloi, bagaimana metadata NFT sepatutnya disematkan, dan sebagainya. Setiap satu daripada keputusan itu mempunyai kos sebenar dan implikasi lock-in. Jadi kami mengambil serius ketepatan apa yang kami terbitkan, dan kami rasa anda patut tahu dengan tepat bagaimana kandungan di blog ini dihasilkan.

Apa yang membezakan kandungan kami#

  • Disahkan produk. Setiap sampel kod, panggilan API, dan angka harga disemak terhadap platform IPFS.NINJA langsung pada masa draf. Jika sesuatu dakwaan tidak dapat diuji terhadap produksi, ia tidak diterbitkan.
  • Ditulis oleh pengendali, bukan pemasar. Orang yang menyemak setiap catatan juga menjalankan platform dari hari ke hari, mengendalikan tiket sokongan, dan membaca isyarat operasi yang dikeluarkannya.
  • Perbandingan adalah jujur. Apabila kami menulis “IPFS.NINJA lwn. Pinata / Filebase / Web3.Storage” kami memetik dokumen awam dan halaman harga mereka secara verbatim. Tiada yang direka-reka lemah (strawman). Jika mereka telah menghantar sesuatu yang kami belum, kami katakannya.
  • Dibantu AI, dimiliki manusia. Seorang manusia yang dinamakan meluluskan setiap artikel sebelum ia diterbitkan. AI membantu dari segi skala; pertimbangan manusia mengawal penerbitan.

Bagaimana setiap artikel dihasilkan#

1. Penciptaan taklimat#

Setiap artikel bermula daripada isyarat sebenar — corak tiket sokongan, kelompok pertanyaan Search Console, atau soalan integrasi pelanggan. Taklimat itu merangkumi khalayak, janji yang dibuat oleh artikel, dan niat carian yang disasarkan.

2. Penyelidikan + pengesahan produk#

Kami membaca sumber utama untuk sebarang dakwaan: spesifikasi IPFS, dokumentasi go-ipfs / kubo, harga semasa dan dokumentasi API pesaing. Setiap petikan kod dijalankan terhadap platform IPFS.NINJA langsung. Jika sesuatu tidak berfungsi seperti yang didokumenkan, kami memfailkannya sebagai pepijat produk sebelum kami menerbitkan artikel.

3. Merangka#

Kebanyakan draf dihasilkan dengan bantuan AI di bawah gesaan penjanaan kandungan yang membawa taklimat artikel, fakta yang disahkan daripada langkah 2, dan panduan suara kami. Draf mendarat dalam repo sebagai fail .md dengan frontmatter penuh, sedia untuk semakan — tiada templat pemasaran, tiada CMS berasingan.

4. Semakan manusia#

Seorang penyemak yang dinamakan membaca setiap draf hujung ke hujung. Tugas mereka adalah untuk menangkap:

  • Sebarang dakwaan yang tidak disokong oleh sumber utama atau tidak dapat dihasilkan semula terhadap produk langsung
  • Perbandingan yang melebih-lebihkan kedudukan kami atau salah menggambarkan tawaran semasa pesaing
  • Nasihat yang akan menyebabkan pembaca kerugian wang sebenar jika mereka mengikutinya — pengiraan harga, pemilihan pelan, laluan migrasi
  • Salinan yang berbunyi seperti pemasaran berbanding kejuruteraan praktikal

5. Penambahbaikan + bacaan akhir#

Isyarat penyemak kembali sebagai semakan, diguna pakai oleh AI terhadap draf asal ditambah maklum balas khusus penyemak. Penyemak kemudian membaca semakan itu untuk mengesahkan setiap isyarat telah ditangani — bukan sekadar diakui.

6. Penyetempatan#

Kami menterjemah setiap artikel yang sedia diterbitkan ke dalam 40 lokal tambahan. Setiap terjemahan mengekalkan ketepatan teknikal artikel asal — sampel kod tidak ditulis semula, hanya prosa yang disetempatkan. Artikel Bahasa Inggeris sentiasa kekal sebagai kanonik; jika varian terjemahan berbeza daripada Bahasa Inggeris, Bahasa Inggeris yang menang.

7. Penerbitan + pendedahan AI#

Setiap artikel yang diterbitkan membawa pendedahan kandungan AI yang kelihatan (bahagian bawah setiap catatan) menerangkan bahawa artikel tersebut dibantu AI dan disemak manusia. Ini merupakan isyarat kandungan berguna Google dan janji kepada pembaca bahawa asal-usul apa yang anda baca tidak disembunyikan.

Mengekalkan kandungan yang segar#

IPFS dan ekosistemnya bergerak pantas. Harga berubah. API dinyahguna. Amalan terbaik berkembang. Kandungan yang tepat semasa ia diterbitkan boleh menjadi mengelirukan setahun kemudian.

Kami menjalankan penjejak SEO dan kesegaran automatik ke atas keseluruhan korpus setiap minggu. Ia menarik isyarat Search Console, menjalankan audit dalam-halaman setiap laman, dan mengenal pasti catatan yang sedang meranking untuk pertanyaan lapuk atau merujuk API yang dinyahguna. Hasilnya menjadi senarai kerja pengeditan konkrit — kebanyakannya mekanikal (membetulkan harga lapuk, menggantikan titik akhir yang dinyahguna), sebahagian memerlukan pertimbangan manusia (sama ada artikel memerlukan penulisan semula yang substantif berbanding penamatan).

Setiap catatan membawa tarikh Updated: pada bahagian hero, berbeza daripada tarikh penerbitan asalnya, supaya anda tahu betapa segarnya kandungan di hadapan anda sebenarnya.

Prinsip editorial kami#

Ketepatan produk mengatasi kelajuan#

Kami lebih rela menerbitkan satu artikel yang tepat dan disahkan setiap minggu berbanding empat artikel yang hanya menyentuh permukaan topik. Jika sesuatu dakwaan tidak dapat disokong terhadap produk langsung, ia tidak diterbitkan. Titik.

Manusia yang dinamakan menyemak segalanya#

Semakan editorial setiap artikel dilakukan oleh seseorang yang khusus dan dinamakan — lihat nama penulis mana-mana catatan. Kami tidak menerbitkan secara tanpa nama dan kami tidak bersembunyi di sebalik suara institusi.

Penyetempatan menghormati sumber#

Terjemahan mengekalkan fakta teknikal artikel asal Bahasa Inggeris. Prosa, tanda baca, dan gaya bahasa khusus lokal diselaraskan; dakwaan asas tidak.

Perbandingan memetik sumber utama#

Setiap dakwaan mengenai pesaing memaut ke dokumen atau halaman harga semasa pesaing itu sendiri. Jika tawaran pesaing telah berubah sejak kami menulis mengenainya, kami membetulkan artikel itu — kami tidak membiarkan perbandingan lapuk kekal.

Praktikal mengatasi bijak#

Kami mengoptimumkan untuk sama ada artikel membantu pembangun sebenar membuat keputusan sebenar — bukan untuk betapa bijaknya rangka kerjanya atau betapa barunya pendekatan itu.

Telus mengenai AI#

Setiap artikel yang dibantu AI menyatakannya, di bahagian bawah, dalam setiap lokal, pada setiap penerbitan. Tiada elakan, tiada rangka kerja pemasaran.

Komitmen kami#

Jika anda menemui sesuatu di blog ini yang salah dari segi fakta, lapuk, atau salah menggambarkan produk pesaing, kami ingin tahu. Hubungi kami melalui hello@ipfs.ninja. Kami membetulkan artikel secara terbuka — setiap pengeditan substantif menaikkan tarikh Updated: dan mengekalkan jejak audit dalam sejarah Git.

Kepercayaan adalah keseluruhan tujuan menulis tentang storan bercirikan kandungan pada mulanya. Kami memegang diri kami kepada piawaian yang sama.

Layari blog Tentang kami