Blog

Saiba como enviar uma publicação para o 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.

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

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.

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.