# Blog

> Saiba como enviar uma publicação para o blog.

---

LLMS index: [llms.txt](/llms.txt)

---

O [_blog_ do OpenTelemetry](/blog/) 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? {#documentation-or-blog-post}

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 {#social-media-content-request}

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](https://github.com/open-telemetry/community/issues/new?template=social-media-request.yml).

## Antes de enviar um post no blog {#before-submitting-a-blog-post}

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](https://github.com/open-telemetry/community/blob/main/social-media-guide.md).

### Criando links para repositórios do GitHub

Ao criar links para o código-fonte em repositórios do GitHub, não utilize a
_branch_ `main` (ou outra _branch_ padrão). Em vez disso, utilize um **commit
específico** ou uma **versão marcada** que reflita o estado do código no momento
em que a postagem do blog foi escrita.

Isso garante que as postagens do blog permaneçam estáveis ​​e não apresentem
problemas no futuro, conforme os repositórios evoluem.

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](#call-for-contributors)

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_](https://github.com/open-telemetry/opentelemetry.io/issues/new?title=New%20Blog%20Post:%20%3Ctitle%3E)
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](https://github.com/open-telemetry/community/) 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 {#call-for-contributors}

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](https://github.com/open-telemetry/community/blob/main/project-management.md)
e
[doações](https://github.com/open-telemetry/community/blob/main/guides/contributor/donations.md).

## Enviar um post no blog {#submit-a-blog-post}

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_](https://github.com/open-telemetry/opentelemetry.io/tree/main/archetypes/blog.md).

### Criar um _fork_ e escrever localmente {#fork-and-write-locally}

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:

   ```sh
   npx hugo new content/pt/blog/$(date +%Y)/nome-curto-da-publicação.md
   ```

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

   ```sh
   npx hugo new content/pt/blog/$(date +%Y)/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](https://github.com/open-telemetry/opentelemetry.io/tree/main/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 {#use-the-github-ui}

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](https://github.com/open-telemetry/opentelemetry.io/tree/main/archetypes/blog.md)
    e clique em **Copy raw content** (Copiar conteúdo) no canto superior direito
    do menu.

1.  Vá para
    [Create a new file (Crie um novo arquivo)](https://github.com/open-telemetry/opentelemetry.io/new/main).

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

1.  Nomeie seu arquivo, por exemplo (`YYYY` sendo o ano atual)
    `content/pt/blog/YYYY/nome-curto-da-publicação/index.md`.

1.  Edite o arquivo Markdown diretamente no GitHub.

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

## Prazos de publicação {#publication-timelines}

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 {#cross-posting-blog-content}

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.
