Blog

O blog do OpenTelemetry comunica novas funcionalidades, relatórios da comunidade e quaisquer novidades que possam ser relevantes para a comunidade OpenTelemetry. Isso inclui tanto usuários finais quanto desenvolvedores. Qualquer pessoa pode escrever uma publicação — veja abaixo quais são os requisitos.

Documentação ou post no blog?

Antes de escrever um post no blog, pergunte a si mesmo se o conteúdo também poderia ser uma boa adição à documentação. Se a resposta for “sim”, crie uma nova issue ou pull request (PR) com seu conteúdo para que seja adicionado à documentação.

Observe que o foco dos mantenedores e aprovadores do site do OpenTelemetry é melhorar a documentação do projeto, então sua publicação terá menor prioridade de revisão.

Solicitação de conteúdo para redes sociais

Se você deseja solicitar a publicação de conteúdo nos canais de redes sociais do projeto OpenTelemetry, e que não seja uma publicação do blog, utilize este formulário.

Antes de enviar um post no blog

As publicações no blog não devem ter caráter comercial e devem conter conteúdo original que seja amplamente relevante para a comunidade OpenTelemetry. As publicações devem seguir as políticas descritas no Guia de Mídias Sociais.

Verifique se o conteúdo pretendido se aplica amplamente à comunidade OpenTelemetry. Exemplos de conteúdos adequados incluem:

• Novas funcionalidades do OpenTelemetry
• Atualizações de projetos do OpenTelemetry
• Atualizações de Grupos de Interesse Especial (SIGs)
• Tutoriais e guias passo a passo
• Integrações com OpenTelemetry
• Chamadas para contribuidores

Conteúdos inadequados incluem:

• Divulgação de produtos de fornecedores (vendor)

Caso sua publicação se encaixe na lista de conteúdos apropriados, crie uma issue com os seguintes detalhes:

• Título da publicação
• Breve descrição e estrutura do conteúdo
• Se aplicável, liste as tecnologias utilizadas. Todas devem ser de código aberto, e deve-se dar preferência a projetos da CNCF em relação a projetos fora da CNCF (por exemplo, use Jaeger para visualização de rastros e Prometheus para visualização de métricas)
• Nome de um SIG relacionado ao conteúdo
• Nome de um patrocinador (mantenedor ou aprovador) desse SIG, que ajudará a revisar o PR. Idealmente, o patrocinador deve ser de uma empresa diferente da sua

Os mantenedores do SIG de Comunicação irão verificar se sua publicação atende a todos os requisitos para ser aceita. Caso não consiga indicar um SIG/patrocinador inicialmente na sua issue, eles poderão te direcionar a um SIG apropriado, com o qual você pode entrar em contato para obter patrocínio. Ter um patrocinador é opcional, mas aumenta a chance de a publicação ser revisada e aprovada mais rapidamente.

Caso sua issue tenha todas as informações necessárias, um mantenedor irá autorizar a submissão do conteúdo.

Chamadas para contribuidores

Caso você esteja propondo a criação de um novo projeto ou SIG, ou se está oferecendo uma doação ao projeto OpenTelemetry, você precisará de contribuidores adicionais para que sua proposta tenha sucesso. Para isso, você pode propor uma publicação no blog do tipo “Chamada para Contribuidores” (CfC, Call for Contributors).

Isso requer que você siga os processos para novos projetos e doações.

Enviar um post no blog

Você pode enviar um post no blog criando um fork do repositório e escrevendo-o localmente ou usando a interface do GitHub. Em ambos os casos, pedimos que siga as instruções fornecidas pelo modelo de post no blog.

Criar um fork e escrever localmente

Depois de configurar o fork local, você pode criar um post no blog usando um modelo. Siga estes passos para criar um post a partir do modelo:

1. Execute o seguinte comando a partir da raiz do repositório:

   npx hugo new content/pt/blog/2025/nome-curto-da-publicação.md
   

   Caso seu post tenha imagens ou outros arquivos, execute o seguinte comando:

   npx hugo new content/pt/blog/2025/nome-curto-da-publicação/index.md
   

2. Edite o arquivo Markdown no caminho informado no comando anterior. O arquivo é inicializado a partir do modelo de post no blog localizado em archetypes.

3. Adicione imagens ou outros arquivos na pasta criada.

4. Quando a publicação estiver pronta, envie-a através de um pull request.

Usando a interface do GitHub

Se preferir não criar um fork local, é possível usar a interface do GitHub para criar uma nova publicação. Siga estes passos para adicionar uma publicação utilizando a interface do GitHub:

1. Acesse o modelo de publicação e clique em Copy raw content (Copiar conteúdo) no canto superior direito do menu.

2. Vá para Create a new file (Crie um novo arquivo).

3. Cole o conteúdo do modelo copiado no primeiro passo.

4. Nomeie seu arquivo, por exemplo content/pt/blog/2025/nome-curto-da-publicação/index.md.

5. Edite o arquivo Markdown diretamente no GitHub.

6. Quando a publicação estiver pronta, selecione Propose changes (Proponha mudanças) e siga as instruções.

Prazos de publicação

O blog do OpenTelemetry não segue um prazo de publicação rigoroso, o que significa que:

• Seu post será publicado quando tiver todas as aprovações necessárias.
• A publicação pode ser adiada se necessário, e os mantenedores não podem garantir que a publicação ocorra antes ou em uma determinada data.
• Alguns posts no blog (anúncios importantes) podem ter prioridade e serem publicados antes do seu.

Republicação em outras plataformas

Se você deseja compartilhar sua publicação no blog do OpenTelemetry em outras plataformas, é permitido fazê-lo. Apenas tenha em mente o seguinte:

• Decida qual versão será a publicação canônica (normalmente, a publicação original no blog do OpenTelemetry).
• Outras versões da publicação devem:
  • Mencionar claramente que o post original foi no publicado no blog do OpenTelemetry.
  • Incluir um link para a publicação original no topo ou no rodapé da página.
  • Adicionar a tag de URL canônica apontando para a publicação do blog do OpenTelemetry, se a plataforma suportar.

Isso auxilia a garantir a atribuição adequada, suporta as melhores práticas de SEO e evita a duplicação de conteúdo.