編集プロセス

Why we publish this#

IPFS.NINJAブログは、開発者がコンテンツアドレス指定ストレージに関する 健全な意思決定——どのピニングサービスを使うか、専用ゲートウェイが いつ価値を持つか、NFTのメタデータを実際にどうピン留めすべきか、 といった判断——を行えるよう支援するために存在します。これらの判断 はいずれも、実際のコストとロックインに関わる重大な影響を持ちます。 だからこそ私たちは、公開する内容の正確性を真剣に受け止めており、 このブログのコンテンツがどのように作られているかを読者に正確に 知っていただきたいと考えています。

What sets our content apart#

• 製品検証済み。 すべてのコードサンプル、API呼び出し、料金の数値 は、執筆時点で実際に稼働しているIPFS.NINJAプラットフォームに対して 検証されます。本番環境でテストできない主張は公開しません。
• マーケターではなく運営者が執筆。 各記事をレビューする人物は、 実際に日々プラットフォームを運用し、サポートチケットに対応し、 そこから発せられる運用シグナルを読んでいます。
• 比較は誠実に。 「IPFS.NINJA vs. Pinata / Filebase / Web3.Storage」 のような記事を書く際は、各社の公式ドキュメントと料金ページを そのまま引用します。藁人形論法は使いません。競合が私たちにない 機能を出荷していれば、その通りに書きます。
• AI支援・人間による最終責任。 公開前には必ず、実名の人間が各 記事を承認します。AIはスケールを助け、公開の可否を判断するのは 人間の判断です。

How each article gets made#

1. 企画（ブリーフ）の作成#

すべての記事は、実際のシグナル——サポートチケットのパターン、 Search Consoleのクエリクラスタ、顧客からの統合に関する質問——から 始まります。ブリーフには、対象読者、記事が果たす約束、そして狙う 検索意図が記載されます。

2. リサーチと製品検証#

あらゆる主張について一次情報を確認します。IPFSの仕様、go-ipfs/kubo のドキュメント、競合各社の現行の料金とAPIドキュメントなどです。 すべてのコードスニペットは、実際に稼働しているIPFS.NINJAプラット フォームに対して実行されます。ドキュメント通りに動作しない場合は、 記事を公開する前に製品のバグとして報告します。

3. 執筆#

ほとんどの下書きは、記事のブリーフ、ステップ2で検証済みの事実、 そして私たちのボイスガイドを含むコンテンツ生成プロンプトのもと、 AI支援によって作成されます。下書きは、完全なフロントマターを備えた .mdファイルとしてリポジトリに配置され、レビューできる状態になり ます——マーケティングテンプレートも別建てのCMSも使いません。

4. 人間によるレビュー#

実名のレビュー担当者が、すべての下書きを最初から最後まで読みます。 その役割は以下を見つけ出すことです。

• 一次情報に裏付けられていない、あるいは実際の製品で再現しない主張
• 私たちの立場を誇張したり、競合の現行の提供内容を誤って伝えたりする比較
• 読者が実行すれば実際に金銭的損失につながりかねないアドバイス——料金計算、プラン選択、移行経路
• 実務的なエンジニアリングというよりマーケティングのように読める文章

5. 推敲と最終確認#

レビュー担当者の指摘は改訂として反映され、元の下書きとレビュー 担当者の具体的なフィードバックをもとにAIが修正を行います。その後、 レビュー担当者が改訂版を読み、すべての指摘が単に認識されただけで なく、実際に対応されたことを確認します。

6. ローカライズ#

公開準備が整った記事はすべて、さらに40のロケールに翻訳します。 各翻訳は原文の技術的な正確性を維持します——コードサンプルは書き 換えず、文章のみをローカライズします。英語版は常に正となる版で あり、翻訳版が英語版と食い違う場合は英語版が優先されます。

7. 公開とAI開示#

公開されるすべての記事には、その記事がAI支援によって作成され、 人間によってレビューされたことを説明する、目に見えるAIコンテンツ 開示（各記事の末尾）が付きます。これはGoogleのヘルプフルコンテンツ のシグナルであると同時に、読んでいる内容の出所を隠さないという 読者への約束でもあります。

Keeping content fresh#

IPFSとそのエコシステムは急速に変化します。価格は変わり、APIは非推奨 になり、ベストプラクティスも進化します。公開時点では正確だった コンテンツも、1年後には読者を誤らせるものになりかねません。

私たちは、コーパス全体を対象に自動化されたSEO・鮮度トラッカーを 毎週実行しています。Search Consoleのシグナルを取得し、ページごとの オンページ監査を行い、古くなったクエリで上位表示されている、あるいは 非推奨のAPIを参照している記事を特定します。その結果は、具体的な 修正作業のリストになります——多くは機械的な修正（古い価格の修正、 非推奨のエンドポイントの置き換え）ですが、一部は人間の判断が必要 なもの（記事を大幅に書き直すべきか、それとも廃止すべきか）です。

すべての記事のヒーロー部分には、最初の公開日とは別に更新日が 記載されており、目の前のコンテンツがどれだけ新しいかが分かるように なっています。

Our editorial principles#

スピードより製品の正確性#

私たちは、テーマを浅くなぞる記事を週に4本出すより、正確で検証済み の記事を週に1本出す方を選びます。実際の製品で裏付けられない主張は、 一切公開しません。以上です。

実名の人間がすべてをレビューする#

すべての記事の編集レビューは、特定の実名の人物によって行われます ——どの記事のバイラインを見ても分かります。私たちは匿名では公開 せず、組織の声の陰に隠れることもありません。

ローカライズは原文を尊重する#

翻訳は英語原文の技術的な事実を維持します。ロケール固有の文章、 句読点、慣用表現は調整されますが、根底にある主張は変わりません。

比較記事は一次情報を引用する#

競合に関するすべての主張は、その競合自身の現行のドキュメントまた は料金ページにリンクします。私たちが記事を書いた後に競合の提供 内容が変わった場合は記事を修正します——古くなった比較をそのまま 放置することはありません。

巧妙さより実用性#

私たちは、その記事が実際の開発者が実際の意思決定を下す助けになる かどうかを重視しており、切り口の巧妙さや着眼点の目新しさは重視 しません。

AIについて透明である#

AI支援で作成された記事はすべて、あらゆるロケール、あらゆる公開先 で、末尾にその旨を明記します。ごまかしもマーケティング的な言い 回しもありません。

Our commitment#

このブログの中に、事実として誤っている、古くなっている、あるいは 競合の製品を誤って伝えている箇所を見つけた場合は、ぜひお知らせ ください。hello@ipfs.ninjaまでご連絡くだ さい。私たちは記事を公然と修正します——実質的な修正はすべて 更新日を更新し、Gitの履歴に監査証跡を残します。

コンテンツアドレス指定ストレージについて書くという行為の意味は、 そもそも信頼にあります。私たちは自分自身にも同じ基準を課しています。