편집 프로세스

이 글을 게시하는 이유#

IPFS.NINJA 블로그는 개발자가 콘텐츠 주소 지정 스토리지에 관한 올바른 결정을 내리도록 돕기 위해 존재합니다 — 어떤 피닝 서비스를 사용할지, 전용 게이트웨이가 언제 가치가 있는지, NFT 메타데이터를 실제로 어떻게 피닝해야 하는지 등입니다. 이러한 결정 하나하나에는 실질적인 비용과 락인(lock-in) 영향이 따릅니다. 그래서 저희는 게시하는 콘텐츠의 정확성을 진지하게 다루고 있으며, 이 블로그의 콘텐츠가 어떻게 만들어지는지 독자 여러분이 정확히 알아야 한다고 생각합니다.

우리 콘텐츠가 다른 이유#

• 제품 검증 완료. 모든 코드 샘플, API 호출, 가격 수치는 초안 작성 시점에 실제 운영 중인 IPFS.NINJA 플랫폼에 대해 확인됩니다. 프로덕션에서 테스트할 수 없는 주장은 게시되지 않습니다.
• 마케터가 아닌 운영자가 작성합니다. 각 글을 검토하는 사람은 실제로 매일 플랫폼을 운영하고, 고객 지원 티켓을 처리하며, 플랫폼이 내는 운영 신호를 직접 읽습니다.
• 비교는 정직합니다. “IPFS.NINJA vs. Pinata / Filebase / Web3.Storage”라는 글을 쓸 때는 그들의 공개 문서와 가격 페이지를 그대로 인용합니다. 허수아비를 세우지 않습니다. 그들이 저희에게 없는 기능을 출시했다면, 그렇다고 명시합니다.
• AI 지원, 사람 책임. 게시 전 모든 글은 이름이 명시된 사람이 승인합니다. AI는 규모를 확장하는 데 도움을 주고, 최종 판단은 사람이 내립니다.

각 글이 만들어지는 과정#

1. 브리프 작성#

모든 글은 실제 신호에서 시작됩니다 — 고객 지원 티켓 패턴, Search Console 검색어 클러스터, 또는 고객의 통합 관련 질문 등입니다. 브리프는 대상 독자, 글이 담아야 할 약속, 그리고 목표로 하는 검색 의도를 정의합니다.

2. 리서치 및 제품 검증#

모든 주장에 대해 원천 자료를 직접 확인합니다: IPFS 스펙, go-ipfs / kubo 문서, 경쟁사의 현재 가격 및 API 문서 등입니다. 모든 코드 스니펫은 실제 운영 중인 IPFS.NINJA 플랫폼에서 실행됩니다. 문서화된 대로 동작하지 않는 부분이 있으면, 글을 게시하기 전에 제품 버그로 등록합니다.

3. 초안 작성#

대부분의 초안은 글의 브리프, 2단계에서 검증된 사실, 그리고 저희의 어조 가이드를 담은 콘텐츠 생성 프롬프트를 통해 AI의 도움을 받아 작성됩니다. 초안은 마케팅 템플릿이나 별도의 CMS 없이, 전체 프론트매터를 갖춘 .md 파일로 저장소에 바로 저장되어 검토를 기다립니다.

4. 사람의 검토#

이름이 명시된 검토자가 모든 초안을 처음부터 끝까지 읽습니다. 검토자의 역할은 다음을 찾아내는 것입니다:

• 원천 자료로 뒷받침되지 않거나 실제 제품에서 재현되지 않는 주장
• 저희의 위치를 과장하거나 경쟁사의 현재 제품을 잘못 전달하는 비교
• 독자가 그대로 따를 경우 실제 금전적 손해를 볼 수 있는 조언 — 가격 계산, 플랜 선택, 마이그레이션 경로 등
• 실용적인 엔지니어링보다 마케팅처럼 읽히는 문구

5. 수정 및 최종 검토#

검토자의 지적 사항은 원래 초안과 검토자의 구체적인 피드백을 바탕으로 AI가 반영한 수정본으로 돌아옵니다. 그 후 검토자는 모든 지적 사항이 단순히 인지된 것이 아니라 실제로 반영되었는지 확인하기 위해 수정본을 다시 읽습니다.

6. 현지화#

게시 준비가 완료된 모든 글은 40개의 추가 로케일로 번역됩니다. 각 번역본은 원문의 기술적 정확성을 그대로 유지합니다 — 코드 샘플은 다시 작성되지 않고, 본문만 현지화됩니다. 영어 원문이 항상 기준이며, 번역본이 영어와 다를 경우 영어가 우선합니다.

7. 게시 및 AI 공개#

게시된 모든 글에는 (모든 게시물 하단에) 눈에 띄는 AI 콘텐츠 공개 문구가 포함되어, 해당 글이 AI의 도움을 받아 작성되고 사람이 검토했음을 설명합니다. 이는 Google의 유용한 콘텐츠 신호이자, 읽고 계신 글의 출처가 숨겨져 있지 않다는 독자에 대한 약속입니다.

콘텐츠를 최신 상태로 유지하기#

IPFS와 그 생태계는 빠르게 변화합니다. 가격이 바뀌고, API가 지원 종료되며, 모범 사례가 진화합니다. 게시 당시에는 정확했던 콘텐츠가 1년 후에는 오해를 불러일으킬 수 있습니다.

저희는 매주 전체 콘텐츠에 대해 자동화된 SEO 및 신선도 추적을 실행합니다. 이 추적은 Search Console 신호를 가져오고, 페이지별 온페이지 감사를 수행하며, 오래된 검색어로 순위가 매겨지거나 지원 종료된 API를 참조하는 게시물을 식별합니다. 그 결과는 구체적인 수정 작업 목록이 됩니다 — 대부분은 기계적인 작업(오래된 가격 수정, 지원 종료된 엔드포인트 교체)이고, 일부는 사람의 판단이 필요한 작업입니다(글을 전면 재작성해야 할지, 아니면 폐기해야 할지 등).

모든 게시물은 원래 게시일과는 별개로 히어로 영역에 업데이트: 날짜를 표시하여, 지금 보고 있는 콘텐츠가 실제로 얼마나 최신인지 알 수 있도록 합니다.

편집 원칙#

속도보다 정확성#

저희는 한 주제를 겉핥기 식으로 다룬 글 네 편보다, 정확하고 검증된 글 한 편을 게시하는 편을 선택합니다. 실제 제품에 대해 뒷받침할 수 없는 주장은 게시되지 않습니다. 예외는 없습니다.

이름이 명시된 사람이 모든 것을 검토합니다#

모든 글의 편집 검토는 특정한, 이름이 명시된 사람이 수행합니다 — 어떤 게시물이든 바이라인을 확인해 보세요. 저희는 익명으로 게시하지 않으며, 기관의 목소리 뒤에 숨지 않습니다.

현지화는 원문을 존중합니다#

번역본은 영어 원문의 기술적 사실을 그대로 유지합니다. 로케일별 문체, 구두점, 관용구는 조정되지만, 그 근간이 되는 주장은 바뀌지 않습니다.

비교는 원천 자료를 인용합니다#

모든 경쟁사 관련 주장은 해당 경쟁사의 현재 문서나 가격 페이지에 링크됩니다. 저희가 글을 쓴 이후 경쟁사의 제품이 변경되었다면, 글을 수정합니다 — 오래된 비교를 그대로 방치하지 않습니다.

영리함보다 실용성#

저희는 프레이밍이 얼마나 영리한지, 관점이 얼마나 참신한지가 아니라, 그 글이 실제 개발자가 실제 결정을 내리는 데 도움이 되는지를 기준으로 최적화합니다.

AI에 대한 투명성#

AI의 도움을 받은 모든 글은 모든 로케일, 모든 게시물의 하단에서 그 사실을 명시합니다. 얼버무리지 않고, 마케팅적으로 포장하지 않습니다.

우리의 약속#

이 블로그에서 사실과 다르거나, 오래되었거나, 경쟁사의 제품을 잘못 전달하는 내용을 발견하시면 알려주시기 바랍니다. hello@ipfs.ninja로 연락해 주세요. 저희는 공개적으로 글을 수정합니다 — 실질적인 수정이 있을 때마다 업데이트: 날짜를 갱신하고 Git 히스토리에 감사 추적 기록을 남깁니다.

신뢰야말로 애초에 콘텐츠 주소 지정 스토리지에 대한 글을 쓰는 이유 전부입니다. 저희 스스로도 같은 기준을 지킵니다.