Pergunta

O que são notas de versão para e quem lê-los? Deve / poderiam ser automatizados por apenas cuspir para fora correções de bugs para a versão atual, ou eles garantem edição humana cuidado? Assim, qualquer pessoa com um link para melhores práticas (raciocínio por trás) no que diz respeito a notas de versão de software?

Foi útil?

Solução

As notas de versão também são importantes para sua organização de testes (se tiver), para que eles saibam o que mudou na liberação e necessidades de testes.

Outras dicas

Correções de bugs e recursos adicionais. Os usuários vão lê-los para determinar se eles devem ir para a dificuldade de instalar uma atualização incremental, ou esperar até que a próxima versão porque este não adiciona qualquer recursos de que necessitam ou corrigir eventuais erros em características que eles estavam usando.

Eu diria que eles, pelo menos, exigem um ser humano para lê-los e certifique-se de que cada nota é útil. Depende de como bom os comentários sobre suas correções de bugs são.

Isso realmente depende de que sua aplicação é construído para e seus objetivos das organizações. No entanto, eu tendem a acreditar que notas de lançamento precisa ser um concisa lista de importantes principais adições, acessórios, ou correções que estão incluídos na versão particular.

Às vezes, uma simples despejo das informações bug sistema de rastreamento é suficiente, outras vezes, eu acho que eles precisam para ser refinado.

A chave é que normalmente Release Notes são acreditados para ser o "look Hey o que nós fizemos" Tipo de lista de alterações.

As nossas notas de lançamento estão humana criada em vez de máquina criada. A tampa três tópicos principais.

  1. O que está incluído nas versões (Lista de arquivos)

  2. Como instalá-lo

  3. O que mudou desde a última versão (Especialmente se as alterações não estão em no entanto, o manual).

itens 1 e 2 não chnage muito de versão para versão, mas eles precisam ser revistos. Ponto 3 toma a maior parte do trabalho.

As notas de versão também são muito importantes em ambiente de produção .

Eles ajudam a responder a velha questão:

O que diabos está funcionando atualmente em produção?

Ou a pergunta mais refinado:? Se este bug foi realmente corrigidos nesta versão

Eu habitualmente ler notas de lançamento. I tendem a querer uma lista completa abrangente de alterações de recursos (ou tão bom quanto plausível), a fim de maior capacitar minha utilização do novo produto.

Eu quero ver quando certos bugs críticos, ou problemas de segurança críticos são resolvidos.

notas e READMEs liberação pode ser realmente importante se o seu cliente tem de tomar medidas especiais além dos procedimentos normais a fim de atualizar. Ele também ser útil para alertar os clientes / utilizadores de quaisquer atualizações db que podem acontecer automaticamente como resultado da instalação de um patch mais recente. A forma como eu vejo, Notas e READMEs liberação deve ser escrito para o público Administrador do sistema. Portanto, incluir os tipos de coisas que eles gostariam de saber sobre:. Resumos de mudanças importantes, como instalar, bugs conhecidos, qualquer coisa que seu software pode fazer isso faria alguém puxar seu cabelo para fora, etc

Nota de lançamento dependerá de sua organização.

Eu posso falar para a minha organização. Usamos nota de lançamento em formato PDF e cada vez que publicar um ClickOnce ou uma versão back-end. Nós enviamos a gerente do escritório da nota de lançamento. Este é um documento usado pelo administrador do topo do negócio (não apenas de TI). Este documento é uma maneira para que eles saibam o que está acontecendo. O que mudou, novos recursos que estão agora em produção, bugs corrigidos, e outra coisa que eles podem querer explicar ao seu usuário.

Este é um documento que pode ser entre 3 a 4 páginas, descrevendo o trabalho que tem sido feito nesta versão com palavras breves.

Este é, naturalmente, altamente dependente do tipo de aplicação / serviço / outros enfeites,
mas eu descobri que a leitura as notas de lançamento das minhas ferramentas favoritas em desenvolvimento etc ..
muitas vezes me fazem tropeçar em cima agradável, assassino interessante ou até mesmo características que eu provavelmente perder se entendi'nt pelo menos roçar as notas ..... bem, talvez nem assassino, mas você me entende; -)

Como a maioria dos usuários avançados de computador (agora que tipo de expressão é que ...)
Eu nunca se preocupar muito com a documentação normal, então isso me dá
algo que pouco algo extra além clicar, pairando e faq'ing ...

Notas de lançamento são para testers e usuários para saber o que há de novo / alterado. Além disso, notas de lançamento pode ser usado como documentação de apoio ao faturamento de uma nova "versão" de um software para o cliente que você está construindo para eles. v1.31 parece muito mais fácil se relacionar e furar.

Ao invés de compilação ambas as listas manualmente, se você pode usar suas notas de lançamento para fazer isso por você é ótimo.

Licenciado em: CC-BY-SA com atribuição
Não afiliado a StackOverflow
scroll top