# Blog

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

---

Site [llms.txt](/pt/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}

Para solicitar uma publicação nos canais de redes sociais do OpenTelemetry em
vez do _blog_, [envie uma solicitação para redes
sociais][submit a social media request].

[submit a social media request]:
  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][Social Media Guide].

[Social Media Guide]:
  https://github.com/open-telemetry/community/blob/main/social-media-guide.md

### Criando links para repositórios do GitHub {#linking-to-github-repositories}

As publicações do _blog_ são [verificadas pelo
markdownlint][checked by markdownlint] (`gh-url-hash`) para evitar links
instáveis do GitHub do tipo `blob`/`tree`.

Caso a verificação aponte um problema:

- Substitua referências à _branch_ padrão (por exemplo, `main`/`master`) por uma
  _tag_/versão ou um _hash_ de _commit_.
- Utilize o _hash_ completo do _commit_, com 40 caracteres (_hashes_ curtos são
  sinalizados).
- Execute `npm run fix:markdown` para corrigir automaticamente o que for
  possível e, em seguida, corrija manualmente os links restantes que forem
  reportados.

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, é
**obrigatório** primeiro
[criar uma _issue_](https://github.com/open-telemetry/opentelemetry.io/issues/new?template=BLOG_POST.yml)
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/) disposto a
  patrocinar a publicação. **O patrocínio de um SIG é obrigatório.**
- Nome de um patrocinador (mantenedor ou aprovador) desse SIG, que fará a
  primeira rodada de revisão antes que o SIG de Comunicação revise a publicação.
  O patrocinador **deve** ser de uma empresa diferente da do autor.

**Abrir uma _issue_ antes de enviar um _pull request_ é obrigatório.** _Pull
requests_ de publicações no _blog_ que não tenham sido precedidos por uma
_issue_ aceita podem ser fechados sem revisão adicional.

Os mantenedores do SIG de Comunicação irão verificar se a publicação atende a
todos os requisitos para ser aceita. O patrocinador do SIG deve concluir sua
revisão antes que o SIG de Comunicação analise a publicação. O autor da
publicação é responsável por encontrar um patrocinador.

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
   npm exec --no -- 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
   npm exec --no -- 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.

## Publicações antigas não são atualizadas {#old-blogs-are-not-updated}

As publicações do _blog_ são consideradas históricas e deixam de ser atualizadas
após cerca de um ano (exceto por alterações essenciais que garantam que o site
seja compilado). Publicações antigas exibem um aviso no topo informando ao
leitor que o conteúdo pode estar desatualizado e que alguns links podem ser
inválidos.

Observe também que publicações antigas não passam por [_lint_ nem por
verificação de links][pr-checks].

[pr-checks]: ../pr-checks/#checks
[checked by markdownlint]: ../pr-checks/#markdown-linter