Pular para o conteúdo

Lançamentos

Um post de lançamento é uma página curta, no estilo de blog, para linkar quando algo sai. Ele fica numa URL sua, tem um texto em markdown e pode fixar os itens do roadmap que foram entregues.

Posts de lançamento

Cada projeto tem um índice de lançamentos em /r/{org}/{project} e uma página por lançamento em:

url
https://opini.dev/r/{org-slug}/{project-slug}/{release-slug}

Escreva lançamentos no painel, em Lançamentos. Cada um tem título, texto em markdown, data de publicação opcional e uma lista de itens que você quer citar pelo nome.

Visibilidade

Três estados de visibilidade, ajustáveis por lançamento:

  • Público: aparece no índice e pode ser indexado. O padrão para "isso está pronto para ler".
  • Só pelo link: acessível pela URL direta, mas não listado em lugar nenhum. Bom para lançamentos discretos, prévias para parceiros e changelogs não listados.
  • Privado: só para admins. Use para rascunhos, post-mortems ou qualquer coisa que visitantes não devem encontrar.

Tirar um lançamento do ar não o apaga: mude para Privado e a URL passa a responder 404, com o conteúdo intacto no painel.

Fixar itens

No editor de lançamentos você pode fixar itens do roadmap, os que realmente foram entregues. Leitores veem os títulos na página do lançamento; quem monta o próprio roadmap pode buscar os mesmos dados na API pública.

Fixar um item não o move. Os itens seguem suas próprias colunas de status (veja páginas públicas); os lançamentos são uma narrativa escolhida por cima disso.

Tags em lançamentos

Lançamentos podem ter tags: segurança, breaking, beta, o que seu projeto precisar. As tags aparecem no índice para que leitores filtrem por tipo. Veja tags para criar tags enquanto digita.

Eventos

Dois tipos de evento de webhook acompanham o estado dos lançamentos:

  • release.published: disparado quando um lançamento passa de Privado ou Só pelo link para Público.
  • release.unpublished: disparado quando um lançamento público volta para Privado.

Um uso comum: inscreva uma URL de notificação em release.published e poste o link do lançamento no seu canal #anuncios automaticamente. Veja webhooks.