Redija notas de versão a partir de pull requests sem divulgar informações internas
Peça ao Beeuni que leia um repositório do GitHub conectado, confira o intervalo da versão e redija notas para os usuários, com referências às alterações.
Um pull request intitulado “Refatorar tarefa de exportação” indica ao revisor onde procurar. Para o cliente, porém, diz muito pouco. As notas de versão precisam explicar o que mudou no produto, quem será afetado e se a mudança está disponível nesta versão.
Confirme o que realmente faz parte da versão
Dê ao agente acesso ao repositório por meio da conexão configurada com o GitHub. Peça que encontre as tags anterior e atual, compare os commits entre elas e examine os pull requests associados. Informe você mesmo o nome do repositório e das tags quando houver várias versões em andamento.
Read the connected repository and compare v1.4.0 with v1.5.0.
Draft release notes for users, grouped into features and fixes.
Inspect the linked PRs and diffs rather than relying on titles alone.
Keep a separate list of internal changes, reversions, and uncertain availability.
Save the draft with PR references. Do not publish a release.Um PR mesclado não necessariamente foi implantado, e uma alteração mesclada na mesma semana pode fazer parte de uma versão posterior. A comparação das tags mostra qual código está incluído. Ainda pode ser necessário confirmar as flags de funcionalidade e o status da implementação gradual com a equipe.
Peça ao agente que crie uma lista de trabalho privada com o PR de origem, o comportamento alterado, os usuários afetados e se a mudança está incluída na versão. Confira as alterações revertidas e os recursos que continuam desativados. Deixe itens incertos fora do rascunho público até que alguém os confirme.
De detalhes de implementação a mudanças para os usuários
Estas notas ilustrativas de PR mostram algumas decisões comuns de edição:
| Nota de trabalho | Rascunho das notas de versão | Decisão editorial |
|---|---|---|
| Manter os filtros selecionados nos parâmetros da URL | Agora, as visualizações filtradas mantêm os filtros quando você compartilha o link. | Descreva o comportamento visível |
| Corrigir envio duplicado ao clicar duas vezes | Corrigimos um problema que podia criar solicitações duplicadas quando se clicava duas vezes em Enviar. | Informe a ação que provoca o problema e seu efeito |
| Reorganizar auxiliares de teste | Omitir das notas públicas | Manter as tarefas de manutenção no registro interno |
| Adicionar exportação atrás de uma flag de funcionalidade desativada | Aguardar até que a exportação esteja disponível | Confirme a disponibilidade antes de anunciar |
Organize as notas pelo que os leitores precisam saber
Quando necessário, use seções como novos recursos, melhorias e correções. Não inclua títulos de seção vazios. Agrupe em uma única entrada vários PRs que entreguem o mesmo recurso. Mantenha separadas as correções distintas que afetem ações diferentes.
Não esconda ações necessárias em uma lista genérica de melhorias. Se um campo da API mudar, informe o formato antigo e o novo e inclua um link para as instruções de migração. Se o comportamento mudar apenas para determinadas contas ou clientes, especifique quem será afetado. Peça ao responsável pelo recurso que confirme esses detalhes.
Mantenha o rascunho vinculado às evidências
- Mantenha as referências a PRs ou commits na versão para revisão, mesmo que elas sejam removidas das notas públicas.
- Confira se todos os recursos anunciados estão disponíveis na versão descrita.
- Remova nomes de hosts internos, credenciais, dados de clientes e conteúdo de issues ainda não publicadas.
- Troque afirmações como “mais rápido” por uma descrição precisa do comportamento, a menos que tenha uma medição para citar.
Peça dois arquivos: o rascunho público e a lista de trabalho, indicando os itens incluídos, excluídos e ainda sem resolução. Depois da revisão, você pode pedir ao agente que atualize o rascunho no repositório, se a conexão permitir gravações. Publicar a versão é uma instrução separada. Se as notas disserem que um problema em um formulário foi corrigido, o guia de testes de sites descreve o registro de reprodução que você pode usar para verificar essa afirmação.
Mais artigos
Infraestrutura para pesquisa de RSI: execução e avaliação de agentes que se aprimoram
Como o Beeuni ajuda a repetir experimentos de melhoria de agentes: editar código e instruções, executar testes, investigar falhas e comparar versões.
Use o Beeuni para executar e avaliar um experimento de ajuste fino de modelo
Peça a um agente que prepare os dados de treinamento, execute um trabalho de ajuste fino no computador de treinamento conectado, investigue falhas e compare as saídas dos modelos.