Como documentar seus testes


Bom, vou falar aqui como documentar seus testes, não só os unitários que os desenvolvedores estão acostumados a criar, mas vou falar de uma norma existente pra isso, a norma IEEE 829.

O propósito desta norma é facilitar a comunicação e, dentre outras coisas, prover uma forma organizada de manter uma documentação eficaz para seus testes.

Então vamos direto ao que interessa…
Esse documento descreve 8 sugestões de documentação:

  • Plano de Teste: Apresenta o planejamento para execução do teste, incluindo a abrangência, abordagem, recursos e cronograma das atividades de teste.

A tarefa de especificação de testes é coberta por 3 documentos:

  • Especificação de Projeto de Teste: Refina a abordagem apresentada no Plano de Teste e identifica as funcionalidades e características a serem testadas pelo projeto e por seus testes associados.
  • Especificação de Caso de Teste: Define os casos de teste, incluindo dados de entrada, resultados esperados, ações e condições gerais para a execução do teste.
  • Especificação de Procedimento de Teste: Especifica os passos para executar um conjunto de casos de teste.

Os relatórios de teste são cobertos por 4 documentos:

  • Diário de Teste: Apresenta registros cronológicos dos detalhes relevantes relacionados com a execução dos testes.
  • Relatório de Incidente de Teste: Documenta qualquer evento que ocorra durante a atividade de teste e que requeira análise posterior.
  • Relatório-Resumo de Teste: Apresenta de forma resumida os resultados das atividades de teste associadas com uma ou mais especificações de projeto de teste e provê avaliações baseadas nesses resultados.
  • Relatório de Encaminhamento de Item de Teste: Identifica os itens encaminhados para teste no caso de equipes distintas serem responsáveis pelas tarefas de desenvolvimento e de teste.

Estes são apenas os “resumos” de cada item.
Você não precisa utilizar todos estes itens necessariamente. O ideal é você utilizar o que mais se adequar a sua necessidade.

Para saber mais sobre esta norma e sobre o assunto visite estes links http://www.ruleworks.co.uk/testguide/IEEE-std-829-1998.htm
http://www.ieee.org.br/
http://www.ieee.org/portal/site

9 thoughts to “Como documentar seus testes”

  1. Olá Bruno!
    A documentação vai depender muito do teu contexto e como o conhecimento é passado onde tu trabalhas.
    Mesmo usando ferramentas de automação, pode-se fazer necessário a documentação dos testes. Pense que uma pessoa não técnica necessite saber o que o teste faz. Podem existir outras diversas possibilidades que irão te fazer criar a documentação mesmo que tu tenhas scripts

  2. Eaí Elias!
    Como leigo em testes, tenho algumas dúvidas:
    – Existe sempre a necessidade de documentar os testes, mesmo usando ferramentas como selenium IDE / RC?
    – Os casos de teste os casos de teste podem ficar mais "enxutos" na sua descrição, especialmente nos itens de especificações de entrada e especificações de Saida, com uso destas ferramentas?

    abraço!

  3. Eaí Elias!
    Como leigo em testes, tenho algumas dúvidas:
    – Existe sempre a necessidade de documentar os testes, mesmo usando ferramentas como selenium IDE / RC?
    – Os casos de teste os casos de teste podem ficar mais "enxutos" na sua descrição, especialmente nos itens de especificações de entrada e especificações de Saida, com uso destas ferramentas?

    abraço!

  4. Eaí Elias!
    Como leigo em testes, tenho algumas dúvidas:
    – Existe sempre a necessidade de documentar os testes, mesmo usando ferramentas como selenium IDE / RC?
    – Os casos de teste os casos de teste podem ficar mais "enxutos" na sua descrição, especialmente nos itens de especificações de entrada e especificações de Saida, com uso destas ferramentas?

    abraço!

  5. Olá Silvia!
    Não entendi muito bem a tua pergunta.
    A Norma IEEE 829 nos apresenta quais são os documentos que devem ser gerados durante um projeto de teste.
    No final da norma é apresentado um exemplo de cada documento, de como eles se comportam no projeto.
    E +- isso?

  6. Olá Elias…
    Estava pesquisando na internet e te encontrei…
    Tenho acesso a norma da IEEE 829, porém ela descreve mais a união dos testes e não nos fornece qualquer exemplo.
    Sabe onde posso encontrar algo?? Algum livro???
    Grata pela ajuda!!
    Silvia (silvia.sinfo@gmail.com)

  7. Olá, Elias!
    Sou estudante de TI e gostaria muito de me aprofundar mais na área de Qualidade de Software.
    Você teria algum exemplo? Algum documento “modelo” deste plano de teste que você cita no artigo?
    Poderia me enviar por e-mail (isabelacolucci@gmail.com)?
    Grata.

Deixe uma resposta

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *