-
Aqui uma novidade no que tange a Clean Code. Até então, só cobravam sobre Clean Code, assuntos como: Nomes significativos, funções e comentários. Aqui, nesta questão é cobrado sobre: Objetos e Estrutura de dados, relativo ao capítulo 6 do referido livro. Para nossa sorte, o que foi cobrado na questão foi bem tranquilo. Sobretudo, neste capítulo, um dos principais temas que é abordado, é sobre o encapsulamento dos dados, seja usando objetos ou estrutura de dados. Quando é dito na questão que as "funções devem ficar expostas", nós temos algo versando o contrário do prega o encapsulamento. Portanto, gab E.
-
isso é um codesmell antigo já
essa discussão já existe desde 2010
https://www.infoq.com/news/2010/03/To-Comment-or-Not-to-Comment
mas a expressão "evitados" deu uma forçada
http://www.inf.fu-berlin.de/inst/ag-se/teaching/K-CCD-2014/Clean-Code-summary.pdf
"The proper use of comments is to compensate for our failure to express ourself in code." Comments do not make up for bad code, rather, we should express ourselves in the code.
-
Devemos buscar sempre ter um código legível e tentar ao máximo evitar gambiarras, infelizmente, é bastante comum nos desenvolvedores de hoje, importam-se em entregar o produto final e não da mínima atenção no que estão fazendo.
Comentários devem ser utilizados para explicar alguma lógica que é mais difícil de entender lendo o código
-
De acordo com o livro Clean Code de Robert C. Martin.
Temos a seguinte passagem: "Alguns comentários são necessários ou beneficos. Mas o melhor é que você não precisa escrever. "
Portanto, gabarito errado.
-
Evitar comentários ou não evitar comentários no código?
Comentário explicativo/descritivo, evitar. Vide questão abaixo do cespe.
Todo comentário, não evitar. Vide questão acima.
Ano: 2016 Banca: Órgão: Prova:
De acordo com as práticas de clean code, comentários em um código-fonte servem para compensar um código mal escrito, devendo, portanto, ser evitados.
Gabarito: Errado
Ano: 2019 Banca: Órgão: Prova:
Comentários explicativos ou descritivos no código devem ser evitados, pois caracterizam um código ruim.
Gabarito: Certo
-
Muito bom, Breno Camargos!
-
Não concordo com o gabarito! " Maioria dos comentários serve apenas para justificar um trecho de código ruim. São como pedidos de desculpas do desenvolvedor por não ter conseguido se expressar em código.
Portanto, pense duas vezes antes de escrever um comentário. Se você está prestes a explicar seu código com comentários é porque, provavelmente, você fracassou em se expressar codificando. Se isso for verdade, prefira refatorar. Deixe o código limpo e auto explicativo.
Então eu marcaria que deve ser "evitado"