Perguntas com a marcação «naming-standards»

Eu trabalhei em lojas que produzem softwares críticos para a vida e lidei com as regras de comentários destinadas a manter o código legível e potencialmente salvar vidas. Na minha experiência, embora o requisito se torne uma tarefa de morte encefálica a ser excluída de uma lista de verificação e …

142 coding-standards  comments  standards  naming-standards  standardization 

Eu já vi essa parte do PEP-8 https://www.python.org/dev/peps/pep-0008/#package-and-module-names Não sei ao certo se isso se refere ao nome do arquivo de um módulo / classe / pacote. Se eu tivesse um exemplo de cada, os nomes de arquivos deveriam estar em letras minúsculas com sublinhados, se apropriado? Ou alguma outra …

138 python  coding-style  naming-standards 

O capítulo do tio Bob sobre nomes no Código Limpo recomenda que você evite codificações em nomes, principalmente em relação à notação húngara. Ele também menciona especificamente a remoção do Iprefixo das interfaces, mas não mostra exemplos disso. Vamos assumir o seguinte: O uso da interface é principalmente para obter …

68 c#  naming  clean-code  naming-standards 

Vindo de um background principalmente em c #, estou acostumado a usar o termo "interface" para descrever um objeto sem implementação que define o comportamento. Em c #, a convenção é acrescentar nomes de interface com "I", como em IEnumerableetc. Obviamente, o conceito tem nomes diferentes em diferentes idiomas. No …

53 naming-standards  swift-language 

Qual é o melhor nome para um método que retorna um booleano? IsSupportContentType ou CanSupportContentType

51 naming  naming-standards 

Se houver um método bool DoStuff() { try { // doing stuff... return true; } catch (SomeSpecificException ex) { return false; } } deveria ser chamado IsStuffDone()? Ambos os nomes podem ser mal interpretados pelo usuário: se o nome é DoStuff()por que ele retorna um valor booleano? Se o nome …

33 naming  methods  naming-standards  parameters  return-type 

Acabei de bifurcar um projeto no Github, fiz minhas alterações etc. Isso me fez pensar: eu vejo principalmente README.txt em projetos de código-fonte aberto e o arquivo que editei foi o Readme.txt. Isso é algum tipo de padronização ou devo ter deixado como está?

33 naming-standards 

Se um software / biblioteca tem algum suporte para a plataforma Windows, quase sempre nomeia seus diretórios e variáveis ​​como win32. Isso é mais prevalente em projetos C / C ++. Até o objetivo triplo do projeto MinGWwin32 . Existe uma razão para isso? Por que não usar um nome …

31 coding-standards  naming-standards 

Eu tenho trabalhado com o objeto XMLHttpRequest em JavaScript recentemente e não pude deixar de notar que a caixa desse nome não faz sentido. Por que 'XML' está tudo em maiúsculas enquanto 'Http' não? Ambos são siglas! Certamente faria mais sentido que o nome fosse um dos seguintes: XmlHttpRequest (PascalCase, …

28 javascript  naming  xmlhttprequest  naming-standards 

É uma convenção bastante estabelecida que nomes de tabelas de banco de dados, pelo menos em SQL, devem ser singulares. SELECT * FROM user;Veja esta pergunta e discussão . Também é uma convenção bastante estabelecida que os nomes de recursos da API RESTful devem ser plurais. GET /users/123e POST /usersveja …

27 rest  api  sql  conventions  naming-standards 

Esta pergunta foi migrada do Stack Overflow porque pode ser respondida no Software Engineering Stack Exchange. Migrou há 8 anos . Estou apenas começando a aprender c #. Vindo de um background em Java, C ++ e Objective-C, acho o Pascal do C # um nome de método bastante exclusivo, …

22 c#  programming-languages  history  naming-standards 

Java SE 8 vem com um novo mecanismo para datas, introduzindo LocalDate, LocalTimee LocalDateTimeclasses para representar instantes de tempo. Para manipular tais instantes, um conjunto de métodos são dadas: LocalDate.plusDays(...), LocalDate.minusDays(...)e assim por diante. Sempre achei que a boa prática era nomear métodos após verbos que descrevem seu objetivo, pois …

21 java  methods  naming-standards 

Depois de ler a resposta do gnat para Por que um método principal estático em Java e C #, em vez de um construtor? Entendo sua resposta como significando que o objetivo de uma classe Java com um método principal estático é define a program entry pointe que ele não …

21 java  naming  naming-standards  entry-point 

Fechado . Esta questão é baseada em opiniões . No momento, não está aceitando respostas. Deseja melhorar esta pergunta? Atualize a pergunta para que ela possa ser respondida com fatos e citações editando esta postagem . Fechado há 4 anos . Ao usar variáveis ​​cujo plural e singular são os …

20 c#  naming  naming-standards  language-discussion 

Estou trabalhando em um projeto que lida com dispositivos físicos e estou confuso sobre como nomear corretamente algumas classes neste projeto. Considerando que os dispositivos reais (sensores e receptores) são uma coisa, e sua representação no software é outra, estou pensando em nomear algumas classes com o padrão de nome …

20 c#  .net  naming  class-design  naming-standards