image

Acesse bootcamps ilimitados e +650 cursos

50
%OFF
Article image

ES

Eder Santos10/12/2022 18:16
Compartilhe

A importância de se documentar um código

    Ao escrevermos linhas de código nos deparamos com muitos desafios e temos que fazer escolhas que afetarão todo o funcionamento do mesmo, desde as linguagens, passando pelos frameworks e comandos para a utilização do mesmo. 

    Mais tarde ao retornamos para esse mesmo código, precisamos de instruções para fazê-lo funcionar. Também desejamos analisar os pontos de melhorias para uma atualização, mas não temos disponível nenhuma informação, nenhum manual. E o mesmo pode acontecer quando um terceiro precisa avaliar o seu progresso.

    Por isso é importante documentar o seu código. Para isso não se tornar uma tarefa maçante ou alguns detalhes se percam durante o processo, pŕeencha o "readme" durante o desenvolvimento do código. A cada atualização, vá incluindo novos detalhes. 

    Com isso, você não só facilita o próprio trabalho, como também de quem tem acesso ao seu código.

    fonte: https://www.devmedia.com.br/documentando-o-codigo-no-visual-studio/28927#:~:text=Um%20c%C3%B3digo%20bem%20 documentado%20pode,fonte%20para%20conhecer%20seu%20funcionamento.

    Compartilhe
    Comentários (2)

    ES

    Eder Santos - 11/12/2022 19:36

    Oi Giuliano, esse artigo foi escrito com o intuito de ajudar, da mesma forma que muitos outros artigos tem me ajudado.


    Caso tenha encontrado algum ponto de melhoria, fique a vontade para informar. Mas claro, sempre com respeito e educação. Todos estamos aqui para aprender :).


    Um abraço!

    GV

    Giuliano Vieira - 10/12/2022 21:48

    Realmente acho que fazer anotações ajuda em muito quem vem rever/ajustar/melhorar o que vc fez um dia, porque já temos como experimencia histórica os egípcios e sua linguagem avançada que até hoje no guem entende muito bem o que queriam dizer, 😂, ou seja se você quer ser compreendido, aprenda a se comunicar🍀