Documentação

Tecnologia
ThiagoDV  
em 06/07/22 12:11

Comentários

Último comentário Só moderadores Só quem eu sigo Ordenar por gostei
beliscaDoido  
em 06/07/2022 12:15
no fim, ainda tem uma linha de código que diz if(var = true or var = false) then ...

; 10; ; 0;
0 '; 0';
Documentação - #1 de 18
Dorito  
em 06/07/2022 12:26
Documentar dói, mas a falta de documentação mata.
; 19; ; 1;
0 '; 0';
Documentação - #2 de 18
arufielli  
em 06/07/2022 12:41
hahahaha , pra mim a documentação tem que estar junto do código.  Código sem comentário, e nomes "exóticos" de variáveis são pior que a morte.

txt_1 , txt_2 , lbl_1, lbl_2    

tem uma frase na internet bem interessante (não sei quem inventou senão daria os créditos ) que "incentiva" você a programar cada vez melhor:

"Always code as if the person who ends up maintaining your code is a violent psychopath who knows where you live."
; 29; ; 0;
0 '; 0';
Documentação - #3 de 18
Lemoura  
em 06/07/2022 12:45
Codigo tem 20.000 linhas de "< if.."
; 1; ; 0;
0 '; 0';
Documentação - #4 de 18
FlyCavok  
em 06/07/2022 13:24
Documentação geralmente é a coisa mais mentirosa que existe em um projeto.

Seguida de comentário de desenvolvedor 

Seguida de nome de variável.

; 6; ; 1;
0 '; 0';
Documentação - #5 de 18
raycaster  
em 06/07/2022 13:43
Será que o pior é não ter documentação ou ter uma documentação desatualizada?

No meu segundo emprego, perguntei da documentação do projeto. Me falaram que não tinha. Eu questionei se não seria importante ter uma, e me responderam: "pode ficar à vontade pra documentar"
; 7; ; 0;
0 '; 0';
Documentação - #6 de 18
sly  
em 06/07/2022 15:27
Eu prefiro que o código seja bem feito e tenha um ambiente de homologação, se tiver isso já é meio caminho andado.

Documentação é raro e quando tem tá desatualizada.

Comentário em código às vezes mais atrapalha que ajuda, pessoal copia o código junto com o comentário, ai altera o código e deixa o comentário igual estava antes.

Agora algo que é muito importante, é conversar com quem realmente usa o sistema, esquece gerente, programador, conversa com quem usa todo dia que você vai entender o sistema, se tiver como ver a pessoa trabalhando no sistema uns dias, melhor ainda.

Já vi muita coisa estranha em código, mas um que ficou na minha memória foi um sistema em que os IFs eram vazios e no ELSE tinha código, ao menos era um padrão de código do sistema
; 1; ; 0;
0 '; 0';
Documentação - #7 de 18
JuquinhaDaBala  
em 06/07/2022 15:56
Tudo isso seria bem menos relevante se tivesse teste automatizado, mas geralmente quem faz teste automatizado não deixa as coisas ficarem ruim a esse ponto.
; 2; ; 0;
0 '; 0';
Documentação - #8 de 18
bebezuco  
em 06/07/2022 16:39
True
; 0; ; 0;
0 '; 0';
Documentação - #9 de 18
trankera  
em 06/07/2022 20:11
"Working software over comprehensive documentation"

Manifesto for Agile Software Development
; 2; ; 0;
0 '; 0';
Documentação - #10 de 18
bebezuco  
em 06/07/2022 20:28
Bah! Mandaste bem, @trankera
; 1; ; 0;
0 '; 0';
Documentação - #11 de 18
zehguleba  
em 07/07/2022 08:15
; 2; ; 0;
0 '; 0';
Documentação - #12 de 18
darthtrader  
em 07/07/2022 10:20
15 inner join dentro de um select, o DBA infarta !
; 2; ; 0;
0 '; 0';
Documentação - #13 de 18
CraqueAllejo  
em 08/07/2022 11:02
E tem o código Cleiton, que é assim:

if ...

-- pass

else

-- pass
; 1; ; 0;
0 '; 0';
Documentação - #14 de 18
frijoles  
em 11/07/2022 11:17
Antes documentação inexistente do que mentirosa/desatualizada... 
; 1; ; 0;
0 '; 0';
Documentação - #15 de 18
JuquinhaDaBala  
em 18/07/2022 09:45
; 4; ; 0;
0 '; 0';
Documentação - #16 de 18
JuquinhaDaBala  
em 27/07/2022 09:34
Consertaram
; 1; ; 0;
0 '; 0';
Documentação - #17 de 18
arufielli  
em 27/07/2022 17:09
Test First ...

postado por @tyurok em 18/07/2022 09:45



; 0; ; 0;
0 '; 0';
Documentação - #18 de 18

Notificar 1º comentário Só moderadores Só quem eu sigo Ordenar por gostei

Você está em Tecnologia > Documentação
por ThiagoDV em 06/07/2022 12:11

14 usuários comentaram este tópico.
Clique para ir para o primeiro comentário do usuário.

Ações Pesquisa Videos Livros Análise de Carteira Desconto FAQs Orientação Esportiva Ofertas e Serviços Bastter System Boletim IR Podcasts Revista Tecnologia - Ajuda Eu Assinar Ações Pesquisa Videos Livros Análise de Carteira Desconto FAQs Ofertas e Serviços Orientação Esportiva Boletim BS Podcasts IR Tecnologia Ajuda eu Revista Assinar Assinar

BastterZap