Processo editorial

Por que publicamos isso#

O blog da IPFS.NINJA existe para ajudar desenvolvedores a tomar boas decisões sobre armazenamento endereçado por conteúdo — qual serviço de pinning usar, quando vale a pena um gateway dedicado, como os metadados de NFT deveriam realmente ser fixados, e por aí vai. Cada uma dessas decisões tem implicações reais de custo e de dependência de fornecedor (lock-in). Por isso levamos a sério a precisão do que publicamos, e achamos que você deveria saber exatamente como o conteúdo deste blog é produzido.

O que diferencia nosso conteúdo#

• Verificado no produto. Cada exemplo de código, chamada de API e valor de preço é conferido na plataforma IPFS.NINJA em produção no momento da redação. Se uma afirmação não pode ser testada em produção, ela não é publicada.
• Escrito por operadores, não por profissionais de marketing. A pessoa que revisa cada post também opera a plataforma no dia a dia, atende aos chamados de suporte e lê os sinais operacionais que ela emite.
• Comparações são honestas. Quando escrevemos “IPFS.NINJA vs. Pinata / Filebase / Web3.Storage”, citamos a documentação pública e as páginas de preços deles literalmente. Nada é distorcido. Se eles lançaram algo que nós ainda não temos, dizemos isso.
• Com apoio de IA, propriedade humana. Uma pessoa identificada aprova cada artigo antes da publicação. A IA ajuda na escala; o julgamento humano é o portão de saída.

Como cada artigo é produzido#

1. Criação do briefing#

Todo artigo parte de um sinal real — um padrão de chamados de suporte, um agrupamento de consultas do Search Console, ou uma dúvida de integração de cliente. O briefing registra o público, a promessa que o artigo faz e a intenção de busca que ele visa.

2. Pesquisa e verificação no produto#

Lemos as fontes primárias de qualquer afirmação: a especificação do IPFS, a documentação do go-ipfs / kubo, os preços e a documentação de API atuais dos concorrentes. Cada trecho de código é executado contra a plataforma IPFS.NINJA em produção. Se algo não funciona como documentado, registramos como bug de produto antes de publicar o artigo.

3. Redação#

A maioria dos rascunhos é produzida com apoio de IA, seguindo um prompt de geração de conteúdo que carrega o briefing do artigo, os fatos verificados na etapa 2 e o nosso guia de voz. Os rascunhos entram no repositório como um arquivo .md com frontmatter completo, prontos para revisão — sem template de marketing, sem CMS separado.

4. Revisão humana#

Um revisor identificado lê cada rascunho do início ao fim. O trabalho dele é detectar:

• Qualquer afirmação que não seja sustentada pelas fontes primárias ou que não se reproduza no produto em produção
• Comparações que exagerem nossa posição ou representem mal a oferta atual de um concorrente
• Conselhos que custariam dinheiro real ao leitor se seguidos — cálculo de preços, escolha de plano, caminhos de migração
• Textos que soam como marketing em vez de engenharia prática

5. Refinamento e leitura final#

Os apontamentos do revisor voltam como revisões, aplicadas pela IA sobre o rascunho original mais o feedback específico do revisor. O revisor então lê a nova versão para confirmar que cada apontamento foi resolvido de fato — não apenas reconhecido.

6. Localização#

Traduzimos todo artigo pronto para publicação em 40 outros idiomas. Cada tradução preserva a precisão técnica do original — os exemplos de código não são reescritos, apenas o texto é localizado. O artigo em inglês é sempre o canônico; se uma variante traduzida diverge do inglês, o inglês prevalece.

7. Publicação e divulgação de IA#

Todo artigo publicado traz uma divulgação visível de conteúdo com IA (no rodapé de cada post) explicando que o artigo teve apoio de IA e revisão humana. Isso é um sinal de conteúdo útil do Google e uma promessa ao leitor de que a proveniência do que você está lendo não está escondida.

Mantendo o conteúdo atualizado#

O IPFS e seu ecossistema evoluem rapidamente. Preços mudam. APIs são descontinuadas. Boas práticas evoluem. Conteúdo que era preciso quando publicado pode se tornar enganoso um ano depois.

Rodamos um rastreador automatizado de SEO e atualização sobre todo o acervo toda semana. Ele coleta sinais do Search Console, faz uma auditoria on-page por página e identifica posts que estão ranqueando para consultas desatualizadas ou referenciando APIs descontinuadas. O resultado vira uma lista de edições concretas — em sua maioria mecânicas (corrigir um preço desatualizado, substituir um endpoint descontinuado), algumas dependendo de julgamento humano (se um artigo precisa de uma reescrita substantiva ou de ser retirado do ar).

Cada post traz uma data de Atualizado em: no topo, distinta da data de publicação original, para que você saiba o quão atual é o conteúdo à sua frente.

Nossos princípios editoriais#

Precisão do produto acima da velocidade#

Preferimos publicar um artigo preciso e verificado por semana a quatro artigos que só arranham a superfície de um tema. Se uma afirmação não pode ser sustentada no produto em produção, ela não é publicada. Ponto final.

Pessoas identificadas revisam tudo#

A revisão editorial de cada artigo é feita por uma pessoa específica e identificada — veja a assinatura de qualquer post. Não publicamos de forma anônima nem nos escondemos atrás de uma voz institucional.

A localização respeita a fonte#

As traduções preservam os fatos técnicos do original em inglês. O texto, a pontuação e as expressões idiomáticas são ajustados conforme o idioma; as afirmações subjacentes, não.

Comparações citam fontes primárias#

Toda afirmação sobre um concorrente linka para a documentação atual ou a página de preços do próprio concorrente. Se a oferta de um concorrente mudou desde que escrevemos sobre ela, corrigimos o artigo — não deixamos comparações desatualizadas no ar.

Prático em vez de espertinho#

Otimizamos para saber se o artigo ajuda um desenvolvedor real a tomar uma decisão real — não para o quão engenhoso é o enquadramento ou o quão inédita é a abordagem.

Transparente sobre o uso de IA#

Todo artigo com apoio de IA diz isso, no rodapé, em todos os idiomas, em toda publicação. Sem meio-termo, sem enquadramento de marketing.

Nosso compromisso#

Se você encontrar algo neste blog que esteja factualmente errado, desatualizado ou que represente mal o produto de um concorrente, queremos saber. Entre em contato pelo hello@ipfs.ninja. Corrigimos artigos abertamente — toda edição substantiva atualiza a data de Atualizado em: e preserva um histórico auditável no Git.

Confiança é o ponto central de escrever sobre armazenamento endereçado por conteúdo, para começo de conversa. Nós nos cobramos o mesmo padrão.