Comentários no EP

Comentários no EP

por José Eduardo Santos -
Número de respostas: 1
Que tipo de comentário deve ser acrescentado?? Algo como: "objeto que sorteia o vencedor em caso de empate", ou "verifica se a carta do Usuário é maior que a carta do PC"???
Em resposta à José Eduardo Santos

Re: Comentários no EP

por Arthur Gabriel de Santana -
Olá.

O objetivo dos comentários é tornar o código mais legível. Então, você deve colocar comentários que traduzam os trechos do código para o português. Por exemplo, se você tiver um pedaço grande do código com vários if's (o que pode acontecer neste EP), você pode comentar cada bloco explicitando a que caso se refere. Porém, não comente trechos óbvios, do tipo

int a = 2*b; // variável a, igual ao dobro de b

Além de escrever mais, o código fica superlotado e você não percebe o que realmente interessa.