O que não fazer… durante o desenvolvimento de um projeto/software — Parte 1

Nesses últimos dias estava pensando em que iria escrever para vocês…..

A ideia veio…exatamente agora!!!!

Estou em alguns projetos bem legais que estão em fase de desenvolvimento e/ou captação de recursos…. E hoje era necessário replicar toda a infra e logica de um dos projetos para uma apresentação que ocorrerá bem longe de mim!

Tudo bem legal… em teoria tudo fácil de se fazer…. e somente uma pessoa sabia exatamente o q tinha q fazer e como…e adivinhem quem é!!!

Não, não é ele…sou eu!!!

Agora você deve estar pensando “Legal, pega a documentação e passa que tudo é feito em 2 tempos….”

Ahh pequeno gafanhoto….está exatamente ai o problema e o motivo desse post…

Eu comecei a documentação…. mas

• Ela está completa? Não

• Essa parte de replicação está lá? Não

• Você começou a documentação assim que começou o projeto? Eh…… não.

• Ela está sendo atualizada conforme está se mexendo? Hummm…. Acho que você já sabe a resposta né?

Pois é amiguinhos…. eu mereço um belo puxão de orelha!!!!

Eu sempre falei da necessidade de documentar tudo que se faz onde trabalhei e com quem converso…mas falhei nesse projeto…

Lado bom, o projeto está no início então não é tão trabalhoso colocar em dia!!!!!

- Para de drama menina!

Não é drama. A falta de documentação em um projeto pode ser bem crítica e levar tudo a perder…. Quer exemplos? Olhe ai alguns!

1. Sem documentação você tem perda de conhecimento. Imagina o seguinte caso, você contratou um desenvolvedor e ele não documentou nada. Depois de um tempo ele pediu demissão….e agora você não sabe como ele fez o trabalho, qual a estrutura do software e etc…. Todo conhecimento adquirido em relação aquele estudo foi embora com o desenvolvedor… Se você contratar outro, o novo desenvolvedor perderá muito tempo para tentar aprender um pouco sobre o projeto.

2. Sem documentação você pode não conseguir replicar o projeto. Nesse caso, você não conseguir mostrar o seu projeto para um investidor por exemplo e perder dinheiro.

3. Sem documentação você não sabe o que foi feito. Como saber se um problema que aparecia de vez enquanto realmente foi resolvido ou não e como (e voltamos ao primeiro exemplo)

A documentação é necessária em qualquer projeto… o que você pode achar que é perca de tempo hoje, pode ser a solução de um problema no futuro e/ou gerar economia de tempo e dinheiro seu ou da sua empresa.

Ate a próxima pessoal!

Post publicado originalmente por mim na plataforma Medium no dia 19/04/2018 (https://medium.com/tht-things-hackers-team/o-que-n%C3%A3o-fazer-durante-o-desenvolvimento-de-um-projeto-software-parte-1-b6a468a450cf)