Documentação de software: uma análise comparativa entre documentação tradicional e living documentation

• Ano de defesa: 2020
• Autor(a) principal: Silva, André Santiago da Fonseca
• Orientador(a): Barbosa, Eiji Adachi Medeiros
• Tipo de documento: Dissertação
• Tipo de acesso: Acesso aberto
• Idioma: por
• Instituição de defesa: Universidade Federal do Rio Grande do Norte
• Programa de Pós-Graduação: PROGRAMA DE PÓS-GRADUAÇÃO EM TECNOLOGIA DA INFORMAÇÃO
• País: Brasil
• Palavras-chave em Português: Desenvolvimento orientado ao comportamento; Documentação de software; Engenharia de requisitos; Documentação viva; Experimento controlado
• Link de acesso: https://repositorio.ufrn.br/handle/123456789/32140

Muitos times de desenvolvimento que trabalham com processos ágeis acabam por menosprezar a importância da documentação do software como ferramenta de apoio a capacidade de escalabilidade de suas soluções e de seu processo produtivo. Deixando de observar, de acordo com os valores ágeis, que embora software em funcionamento seja bastante valorizado, ter uma documentação abrangente também pode ser necessário. Em um ambiente de desenvolvimento caracterizado pela alta rotatividade de colaboradores e diversidade de domínios das soluções, o que muitas vezes observamos são equipes de desenvolvimento tentando adaptar atividades de Engenharia de Requisitos e documentação de software dos processos de desenvolvimento ditos tradicionais. Essa situação pode impactar no entendimento dos desenvolvedores quanto ao comportamento das funcionalidades do software, diminuindo o diferencial competitivo da equipe de desenvolvimento ágil. Nesta dissertação quantificamos o impacto que a documentação do software tem no entendimento dos desenvolvedores quanto ao comportamento das funcionalidades de software. Para isso, através de um experimento controlado, fizemos uma análise comparativa entre um tipo de documentação de software caraterístico dos processos de desenvolvimento tradicionais e a living documentation (documentação viva, em tradução livre) gerada a partir da estratégia de Desenvolvimento Orientado ao Comportamento (do inglês Behavior Driven Development - BDD). O estudo chegou a conclusão que, dado o contexto em que se desenvolveu, a documentação tradicional parece facilitar o entendimento quanto ao comportamento das funcionalidades por parte dos desenvolvedores, o que indica que a implantação da living documentation pode ter mais esse desafio a ser vencido na sua implantação.