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:
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.