Skip to main content
Tipo da pesquisa Sintaxe da busca
Tags [tag]
Exatamente "palavras aqui"
Autor user:1234
user:me (seu)
Pontuação score:3 (3+)
score:0 (nenhum)
Respostas answers:3 (3+)
answers:0 (nenhum)
isaccepted:yes
hasaccepted:no
inquestion:1234
Visualizações views:250
Código code:"if (foo != bar)"
Seções title:maçãs
body:"maçãs laranjas"
URL url:"*.example.com"
Saves in:saves
Status closed:yes
duplicate:no
migrated:no
wiki:no
Tipos is:question
is:answer
Excluir -[tag]
-maçãs
Para obter mais detalhes sobre a pesquisa avançada visite nossa página de ajuda
Resultados com a tag
Opções de pesquisa answers only not deleted user 101

Comentários em linguagens de programação, são trechos de texto no código fonte da aplicação que não são interpretadas como parte do código, servem para auxiliar o desenvolvedor no entendimento do código.

28 votos
Aceito

TODO - O que é, qual sua utilidade e como usar?

É comum IDEs ou pelo menos extensões deles terem alguma coisa que vasculham o código procurando comentários que começam com: TODO: ("para fazer") Alguém [eu] precisa arrumar isso urgente FIXME: ("me conserte … ") Tem um erro que precisa ser consertado aqui, mas funciona (TOFIX:) HACK: ("gambi") Não teve outro jeito de resolver pra cumprir o prazo, depois melhoro XXX: ("atenção") Alguns editores destacam comentários
Maniero's user avatar
  • 484mil
25 votos

Como saber a medida certa de comentários?

Hoje comentários quase não são necessários. … O que deve conter nos comentários? …
Maniero's user avatar
  • 484mil
23 votos
Aceito

Por que não comentar o código?

Também achei que o código do mgibsonbr acrescentou muito pouco, se fosse pra melhorar teria que fazer mais abstrações e não mais comentários ou quebrar linha. Pode ter melhorado, mas não muito. … Tem uma pergunta sobre Como saber a medida certa de comentários?. Falo sobre anti pattern quando começa por informação demais no código. Tudo tem motivo, não é regra boba inventada. …
Maniero's user avatar
  • 484mil
20 votos
Aceito

Trechos inteiros de códigos comentados. Por que?

Note que não estou falando de comentários válidos que ajudam explicar alguma situação do código. …
Maniero's user avatar
  • 484mil
19 votos
Aceito

Comentários em CSS com // ao invés de /* */

Hoje não causa problema. Mas e amanhã? Você não deve usar nada que não está na especificação justamente porque ela não é future proof. Se usar isto e no futuro a especificação dizer que isto serve par …
Maniero's user avatar
  • 484mil
17 votos

O que são comentários WET?

São os comentários óbvios, que dizem exatamente o que o código já está dizendo de forma clara e legível para qualquer programador. … O WET não se aplica só a comentários, qualquer duplicação real, e que não são iguais apenas por coincidência, devem ser evitadas. …
Maniero's user avatar
  • 484mil
12 votos
Aceito

Existe uma forma correta de comentar um trecho de código?

Mas estamos falando de comentários fixos. … Não vou entrar em detalhes, já existem perguntas sobre isso: Comentários em código ao trabalhar em grupo Como saber a medida certa de comentários? …
Maniero's user avatar
  • 484mil
8 votos

Como fazer um comentário em HTML?

Cada linguagem tem sua sintaxe para comentários e outras coisas. Em HTML é o <!-- para abrir e --> para fechar. Não tem uma forma de comentário inline como é possível nas linguagens citadas. …
Maniero's user avatar
  • 484mil
8 votos
Aceito

O que é uma documentação formal?

Comentários comuns devem ser raros e explicam o porquê de ter feito aquilo e não o que fez. Alguns comentários comuns ocupam mais de uma linha porque eles explicam o porquê. … Entenda mais sobre comentários comuns. E explicando porque comentários não deveriam ser usados. Os comentários de documentação são sempre bem vindos ao contrário dos comuns. …
Maniero's user avatar
  • 484mil
8 votos
Aceito

Comentários em expressões regulares?

Sim, estes são comentários para as expressões regulares do C# (ou mais especificamente do .NET, já que ele é válido para todas as linguagens que adotam o .NET como biblioteca). … Em outras linguagens ou mais especificamente em outras bibliotecas de expressões regulares os comentários podem estar disponíveis com sintaxe um pouco diferente. Documentação. …
Maniero's user avatar
  • 484mil
7 votos
Aceito

Recomendações para comentários em uma interface e seus contratos

Seguir boas práticas por seguir é uma péssima prática. Você deve fazer o que é certo para a sua aplicação. Deve pensar porque deve fazer algo. Porque uma prática específica deve ser usada naquele caso …
Maniero's user avatar
  • 484mil
6 votos
Aceito

Diferença entre // e /*...*/

Porém, depois nos comentários foi melhor explicitado que há problema de renderização do jQuery. Quanto menos usar jQUery melhor, ele é lento e traz problemas. Mas como usou teve um deles. …
Maniero's user avatar
  • 484mil
6 votos
Aceito

Definir um comentário padrão para todo novo projeto

Os gabaritos usados para iniciar os códigos ficam em C:\VisualStudioInstallationDirectory\Common7\IDE\ItemTemplates\VisualBasic\1033\ e pode mexer neles à vontade. Obviamente que VisualStudioInstallat …
Maniero's user avatar
  • 484mil
6 votos

Comentários diferentes em JavaScript

Não, não há nada em JavaScript que torne o comentário de três barras em algo diferente. Outras linguagens usam assim, em JS no máximo você pode considerar isto como diferente, mas para a linguagem é o …
Maniero's user avatar
  • 484mil
5 votos

Descrição de uma declaração em função

Comentários são ruins Se o código for bem escrito futuramente ele será fácil de dar manutenção sem comentários. … Conclusão Não sou voz dissonante na comunidade de desenvolvedores: Comentários em código ao trabalhar em grupo Como saber a medida certa de comentários? …
Maniero's user avatar
  • 484mil

15 30 50 por página