Perguntas com a marcação «comments»

Perguntas sobre como escrever comentários no código.






17
Os comentários do TODO fazem sentido? [fechadas]
Estou trabalhando em um projeto bastante grande e tive a tarefa de fazer algumas traduções para ele. Havia toneladas de etiquetas que não foram traduzidas e, enquanto eu vasculhava o código, encontrei esse pequeno pedaço de código //TODO translations Isso me fez pensar sobre o sentido desses comentários para si …


13
O código comentado pode ser uma documentação valiosa?
Eu escrevi o seguinte código: if (boutique == null) { boutique = new Boutique(); boutique.setSite(site); boutique.setUrlLogo(CmsProperties.URL_FLUX_BOUTIQUE+fluxBoutique.getLogo()); boutique.setUrlBoutique(CmsProperties.URL_FLUX_BOUTIQUE+fluxBoutique.getUrl()); boutique.setNom(fluxBoutique.getNom()); boutique.setSelected(false); boutique.setIdWebSC(fluxBoutique.getId()); boutique.setDateModification(new Date()); boutiqueDao.persist(boutique); } else { boutique.setSite(site); boutique.setUrlLogo(CmsProperties.URL_FLUX_BOUTIQUE+fluxBoutique.getLogo()); boutique.setUrlBoutique(CmsProperties.URL_FLUX_BOUTIQUE+fluxBoutique.getUrl()); boutique.setNom(fluxBoutique.getNom()); //boutique.setSelected(false); boutique.setIdWebSC(fluxBoutique.getId()); boutique.setDateModification(new Date()); boutiqueDao.merge(boutique); } Há uma linha comentada aqui. Mas acho que isso torna o código mais claro, …




9
O que XXX significa em um comentário? [fechadas]
O que as pessoas geralmente querem dizer sempre que você vê XXXum comentário. Ocasionalmente, vejo um comentário como este: # XXX - This widget really should frobulate the whatsit Claro, posso dizer o que o comentário significa, mas o que o XXX geralmente significa? Está dizendo "Isso é um hack" …


7
TODO comenta com prazos?
fundo Estou trabalhando em uma equipe que procura implementar implantações com tempo de inatividade zero. Planejamos usar uma estratégia de implantação azul / verde para conseguir isso. Uma das coisas que estou percebendo ao fazer a pesquisa é como fica complicado fazer alterações no banco de dados. Uma operação simples …

11
Por que os blocos de /// comment são importantes?
Alguém disse uma vez que deveríamos prefixar todos os nossos métodos com os /// <summary>blocos de comentários (C #), mas não explicou o porquê. Comecei a usá-los e descobri que eles me incomodavam um pouco, então parei de usá-los, exceto para bibliotecas e métodos estáticos. Eles são volumosos e eu …
49 c#  comments 

Ao utilizar nosso site, você reconhece que leu e compreendeu nossa Política de Cookies e nossa Política de Privacidade.
Licensed under cc by-sa 3.0 with attribution required.