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:
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
Edite o arquivo Markdown no caminho informado no comando anterior. O arquivo é inicializado a partir do modelo de post no blog localizado em archetypes.
Adicione imagens ou outros arquivos na pasta criada.
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:
Acesse o modelo de publicação e clique em Copy raw content (Copiar conteúdo) no canto superior direito do menu.
Cole o conteúdo do modelo copiado no primeiro passo.
Nomeie seu arquivo, por exemplo
content/pt/blog/2025/nome-curto-da-publicação/index.md
.Edite o arquivo Markdown diretamente no GitHub.
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.
Feedback
Was this page helpful?
Thank you. Your feedback is appreciated!
Please let us know how we can improve this page. Your feedback is appreciated!