9
respostas

Documentação "ninguém vai Ler"

Entendo que documentação técnica é registro, manual e relatórios de lições apreendidas. Apesar de entregarmos o software e é a prioridade e o objetivo. Mas o registro, a forma, o detalhe e a customização que foi realizada é necessário, agregar de forma digital para a consulta de quem se interessar. Por exemplo, em uma auditoria ou comissão....precisamos de histórico do processo e o passo a passo das causas e efeitos.

9 respostas

Olá, Vanessa! Tudo bem com você?

De fato, documentação é um processo extremamente importante para compreensão maior do software e ajuda muito no processo de correção de bugs ou novas implementações. No entanto o instrutor relata que a documentação é importante mas a prioridade é a entrega do software em si. Pois sem produto final até a documentação perde o sentido.

Porém, essa questão que você levantou é muito coerente porque há equipes que acreditam que se a documentação não é prioridade, ela não precisa ser feita. Isso é um grande engano, pois a documentação é essencial para outras etapas do processo, inclusive de atualizações e implementações.

Obrigada pela contribuição de sua perspectiva!

Um abraço e bons estudos

A empresa não pode perder o foco, o importante é o produto final, que é o software.

concordo que seja o importante mas não a única etapa do processo de trabalho.

Sabemos que o software funcional é prioridade, mas a documentação é importante também..

Olá Vanessa, concordo com sua análise, a entrega do software é a prioridade e também o objetivo. Mas de forma alguma é tudo, e a documentação também é parte do projeto e não pode ou deve ser negligenciada assim como camila.pessoa citou "a documentação é um processo extremamente importante para compreensão maior do software e ajuda muito no processo de correção de bugs ou novas implementações." e ainda outra citação importante da camila.pessoa: "....há equipes que acreditam que se a documentação não é prioridade, ela não precisa ser feita. Isso é um grande engano, pois a documentação é essencial para outras etapas do processo, inclusive de atualizações e implementações."

Fica a pergunta : a parte de documentação causa prejuízo ao método ágil ao ponto de ser descartada do processo?

A parte de documentação causa prejuízo ao método ágil ao ponto de ser descartada do processo?

A documentação prejudicava o processo porque era muito extensa, mas no método ágil ela é simplificada, ou seja, apenas o essencial deve ser documentado, mas descartar a documentação não acho viável, pois é ela que permite que todos conheçam o software, além disso na etapa de levantamento dos requisitos funcionais e não funcionais é possível identificar quais são os recursos viáveis e inviáveis a serem aplicados, e como as atualizações dos sistemas ocorrem de acordo com o que foi documentado, com o tempo podem ser necessárias e devem seguir os mesmos protocolos do projeto original.

  • Software em funcionamento, mais do que documentação abrangente

Entendo então que a documentação de forma alguma prejudica o método ágil e que não deve ser descartada do projeto.

A parte de documentação causa prejuízo ao método ágil ao ponto de ser descartada do processo?

A documentação prejudicava o processo porque era muito extensa, mas no método ágil ela é simplificada, ou seja, apenas o essencial deve ser documentado, mas descartar a documentação não acho viável, pois é ela que permite que todos conheçam o software, além disso na etapa de levantamento dos requisitos funcionais e não funcionais é possível identificar quais são os recursos viáveis e inviáveis a serem aplicados, sendo que as atualizações dos sistemas ocorrem de acordo com o que foi documentado, com o tempo podem ser necessárias e devem seguir os mesmos protocolos do projeto original.

  • Software em funcionamento, mais do que documentação abrangente

Entendo então que a documentação de forma alguma prejudica o método ágil e que não deve ser descartada do projeto.

A parte de documentação causa prejuízo ao método ágil ao ponto de ser descartada do processo?

A documentação prejudicava o processo porque era muito extensa, mas no método ágil ela é simplificada, ou seja, apenas o essencial deve ser documentado, mas descartar a documentação não acho viável, pois é ela que permite que todos conheçam o software, além disso na etapa de levantamento dos requisitos funcionais e não funcionais é possível identificar quais são os recursos viáveis e inviáveis a serem aplicados, além disso as atualizações dos sistemas ocorrem de acordo com o que foi documentado, com o tempo podem ser necessárias e devem seguir os mesmos protocolos do projeto original.

  • Software em funcionamento, mais do que documentação abrangente

Entendo então que a documentação de forma alguma prejudica o método ágil e que não deve ser descartada do projeto.

Olá Ana Paula Monteiro Moreira gostei muito da explicação e fundamento, te agradeço os esclarecimentos.