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...
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...
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 é...
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...
Qual é o melhor nome para um método que retorna um
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
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...
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 próprio como Windows...
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
É 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...
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...
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 deve ser o próprio programa. Pode...
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...
Qual é a história por trás da convenção de nomear constantes em maiúsculas? Minha intuição é que ele começou com o pré-processador C, onde as pessoas desenvolveram uma prática para nomear macros de pré-processador em todas as letras maiúsculas, para que elas vivessem efetivamente em um espaço para...
Eu recebo muitas críticas de outros programadores devido ao meu uso de case completo e adequado para todas as minhas variáveis. Por exemplo, seu programador típico usará employeeCountpara um nome de variável, mas eu uso EmployeeCount. Uso maiúsculas e minúsculas para tudo , seja um método nulo,...
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...
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...
Nos velhos tempos, fizemos a notação húngara. Agora isso é considerado passé e, na maioria das vezes, não o uso mais, mas ainda acho útil o m_prefixo para indicar os campos dos membros. Para mim, se estou lendo o código de outra pessoa e vejo o seguinte: count = 3; Suponho que countseja uma...
Suponha que eu tenha um formulário no meu aplicativo Web em que os usuários possam fazer upload de uma foto do perfil. Tenho poucos requisitos sobre tamanho de arquivo, dimensões, etc., mas quando o usuário carrega a imagem, como devo nomeá-los no meu sistema? Suponho que precisaria ser...
Atualmente, meu projeto está sofrendo de problemas de nomeação de ambiente. Pessoas diferentes têm suposições diferentes sobre quais ambientes devem ser nomeados ou o que os nomes designam, e isso causa confusão ao discuti-los. Pesquisei um pouco e não encontrei nenhum padrão por aí. Os termos...