Processo editorial

Porque publicamos isto#

O blogue da IPFS.NINJA existe para ajudar programadores a tomar decisões sólidas sobre armazenamento com endereçamento por conteúdo — que serviço de pinning usar, quando vale a pena um gateway dedicado, como os metadados de NFT devem realmente ser fixados, e assim por diante. Cada uma destas decisões tem implicações reais de custo e de dependência de fornecedor (lock-in). Por isso levamos a sério a exatidão do que publicamos, e achamos que deve saber exatamente como é feito o conteúdo deste blogue.

O que distingue o nosso conteúdo#

• Verificado no produto. Cada exemplo de código, chamada à API e valor de preço é verificado na plataforma IPFS.NINJA em produção no momento da redação. Se uma afirmação não puder ser testada em produção, não é publicada.
• Escrito por operadores, não por profissionais de marketing. A pessoa que revê cada artigo também gere a plataforma no dia a dia, trata dos pedidos de suporte e lê os sinais operacionais que ela emite.
• As comparações são honestas. Quando escrevemos “IPFS.NINJA vs. Pinata / Filebase / Web3.Storage” citamos literalmente a documentação e as páginas de preços públicas deles. Nada é distorcido. Se lançaram algo que nós ainda não temos, dizemo-lo.
• Assistido por IA, propriedade humana. Um humano identificado aprova cada artigo antes da publicação. A IA ajuda na escala; o critério humano decide se publica.

Como cada artigo é feito#

1. Criação do briefing#

Cada artigo parte de um sinal real — um padrão de pedidos de suporte, um conjunto de consultas do Search Console, ou uma pergunta de integração de um cliente. O briefing capta o público-alvo, a promessa que o artigo faz e a intenção de pesquisa que visa.

2. Investigação 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 excerto de código é executado na plataforma IPFS.NINJA em produção. Se algo não funcionar conforme documentado, registamos como um bug de produto antes de publicarmos o artigo.

3. Redação#

A maioria dos rascunhos é produzida com assistência de IA, seguindo um prompt de geração de conteúdo que transporta o briefing do artigo, os factos verificados no passo 2 e o nosso guia de estilo. Os rascunhos chegam ao repositório como um ficheiro .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. A sua função é detetar:

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

5. Aperfeiçoamento e leitura final#

As observações do revisor voltam sob a forma de revisões, aplicadas por IA sobre o rascunho original mais o feedback específico do revisor. O revisor lê então a revisão para confirmar que cada observação foi resolvida — não apenas reconhecida.

6. Localização#

Traduzimos cada artigo pronto a publicar para mais 40 localizações. Cada tradução preserva a exatidã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 a versão canónica; se uma variante traduzida divergir do inglês, prevalece o inglês.

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

Cada artigo publicado tem uma divulgação visível sobre o uso de IA (no fundo de cada publicação) explicando que o artigo foi assistido por IA e revisto por humanos. Este é um sinal de conteúdo útil para a Google e uma promessa ao leitor de que a proveniência do que está a ler não está escondida.

Manter o conteúdo atualizado#

O IPFS e o seu ecossistema evoluem rapidamente. Os preços mudam. As APIs ficam obsoletas. As boas práticas evoluem. Conteúdo que era exato quando foi publicado pode tornar-se enganador um ano depois.

Executamos um rastreador automático de SEO e de atualidade sobre todo o corpus, semanalmente. Este recolhe sinais do Search Console, faz uma auditoria on-page por página e identifica publicações que estão a posicionar-se para consultas desatualizadas ou que referem APIs obsoletas. O resultado torna-se uma lista de trabalho de edições concretas — na maioria mecânicas (corrigir um preço desatualizado, substituir um endpoint obsoleto), algumas dependentes de critério humano (se um artigo precisa de uma reescrita substancial ou de ser retirado).

Cada publicação apresenta uma data de Atualização no destaque principal, distinta da data de publicação original, para que saiba quão atual é de facto o conteúdo que tem à sua frente.

Os nossos princípios editoriais#

Exatidão do produto acima da velocidade#

Preferimos publicar um artigo exato e verificado por semana a quatro artigos que abordam um tema superficialmente. Se uma afirmação não puder ser sustentada face ao produto em produção, não é publicada. Ponto final.

Humanos identificados revêm tudo#

A revisão editorial de cada artigo é feita por uma pessoa concreta e identificada — veja a assinatura de qualquer publicação. 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 factos técnicos do original em inglês. O texto, a pontuação e as expressões idiomáticas específicas de cada localização são adaptados; as afirmações subjacentes não.

As comparações citam fontes primárias#

Cada afirmação sobre um concorrente remete para a documentação atual ou 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 por corrigir.

Prático acima de engenhoso#

Otimizamos para saber se o artigo ajuda um programador real a tomar uma decisão real — não para saber quão engenhosa é a abordagem ou quão original é a perspetiva.

Transparentes quanto à IA#

Cada artigo assistido por IA diz-o, no fundo, em cada localização, em cada publicação. Sem rodeios, sem enquadramento de marketing.

O nosso compromisso#

Se encontrar algo neste blogue que esteja factualmente errado, desatualizado, ou que represente mal o produto de um concorrente, queremos saber. Contacte-nos através de hello@ipfs.ninja. Corrigimos os artigos abertamente — cada edição substancial atualiza a data de Atualização e preserva um registo de auditoria no histórico do Git.

A confiança é o propósito de escrever sobre armazenamento com endereçamento por conteúdo, para começar. Aplicamos a nós próprios o mesmo padrão.