Pular para o conteúdo
45

Documentação técnica: devo exigir do programador freelancer?

Oi, galera! Estou com uma dúvida que pode parecer básica, mas é algo que me preocupa bastante. Estou pensando em contratar um programador freelancer para um projeto que tenho em mente, mas não sei se devo exigir uma documentação técnica do trabalho que ele vai fazer. Já ouvi histórias de pessoas que contrataram freelancers e, no final, ficaram sem entender nada do que foi feito. Isso me deixa com um pé atrás, porque eu quero ter certeza de que, se precisar fazer ajustes ou até mesmo mudar de programador no futuro, eu vou conseguir entender o que foi desenvolvido.

Por outro lado, eu sei que exigir documentação pode ser um pouco complicado, especialmente se o freelancer já estiver com um preço mais alto. Eu não quero parecer que estou desconfiando do trabalho dele, mas também não quero me colocar em uma situação em que eu fique refém do conhecimento dele. Então, o que vocês acham? Vale a pena exigir essa documentação técnica? Como posso abordar esse assunto com o freelancer sem parecer que estou duvidando da capacidade dele?

Se alguém já passou por isso e puder compartilhar a experiência, seria muito útil. Estou aberto a sugestões e dicas sobre como lidar com essa situação. Obrigado!

Diego Rodrigues Diego Rodrigues · Consultor Mercado Livre há 1 semana 152 visualizações 4 respostas

Receba ajuda de nossos Especialistas

Temos um time de especialistas treinado para te ajudar com o que você precisa.

Falar com Especialista

4 Respostas

55
Melhor resposta

Com certeza, você deve exigir documentação técnica do programador freelancer. Isso não só protege você, mas também ajuda o próprio freelancer a organizar seu trabalho. Quando eu contratei um desenvolvedor para um projeto anterior, pedi uma documentação clara e objetiva. Ele criou um arquivo com explicações sobre cada parte do código, como instalar e rodar o projeto, além de um guia para futuras manutenções. Isso me salvou quando precisei fazer ajustes e até mesmo quando decidi mudar de programador.

A documentação não precisa ser um livro, mas deve conter informações essenciais. Um exemplo prático: se o freelancer cobra R$ 1.500,00 pelo projeto, você pode negociar um adicional de R$ 300,00 para incluir a documentação. Isso vale a pena, pois evita dores de cabeça no futuro e garante que você tenha controle sobre o que foi feito. Não tenha medo de abordar o assunto, é um direito seu como cliente.

Vanessa Barbosa Vanessa Barbosa 10.652 karma há 1 semana
30

Uma observação prática é que a falta de documentação pode sair caro no futuro. Se você precisar de manutenção ou alterações, pode acabar gastando muito mais do que se tivesse exigido a documentação desde o início. Além disso, considere que, se o freelancer não estiver disposto a fornecer documentação, pode ser um sinal de que ele não está tão comprometido com a qualidade do trabalho. Avalie isso na hora de escolher o profissional.

Letícia Moura Letícia Moura 59 karma há 1 semana

Receba ajuda de nossos Especialistas

Temos um time de especialistas treinado para te ajudar com o que você precisa.

Falar com Especialista
17

Uma dica adicional que eu posso dar é sempre ter um contrato claro. No contrato, você pode especificar que a entrega do projeto deve incluir a documentação técnica. Isso ajuda a garantir que o freelancer saiba desde o início que você valoriza esse aspecto. Além disso, você pode solicitar que ele utilize ferramentas como o GitHub, onde pode deixar comentários e explicações diretamente no código. Isso facilita muito a compreensão do trabalho realizado.

Aline Nunes Aline Nunes 21 karma há 1 semana
8

Outra perspectiva é que nem todo freelancer tem a mesma abordagem em relação à documentação. Alguns podem ser mais focados na entrega do código e menos na documentação. Uma alternativa é você pedir um vídeo explicativo ou uma reunião ao final do projeto, onde ele possa te mostrar o que foi feito. Isso pode ser uma solução mais leve e ainda assim te dá uma visão clara do trabalho.

Além disso, você pode incluir na proposta um item que mencione a necessidade de um resumo ou guia de uso, sem necessariamente exigir uma documentação formal. Isso pode facilitar a comunicação e deixar o freelancer mais à vontade.

Amanda Lima Amanda Lima 91 karma há 1 semana