Nomeando Membros


Eu sempre tive (e ainda tenho) uma enorme dificuldade em nomear membros (eventos, métodos, propriedades, etc.), tipos (classes, estruturas, etc.) e, até mesmo, objetos dentro do SQL Server (Tabelas, SPs, etc.). Eu sempre tive a impressão de que o correto seria nomear em ingles, mas isso me trouxe um outro problema: encontrar um termo correspondente em ingles para cada um dos termos, que são muito específicos ao ambiente que trabalho.

A solução para isso? Simples! Passei a nomear tudo em portugues, inclusive mantendo as preposições “de”, “do”, etc.. Isso está ajudando muito. Além de facilitar para os outros membros da equipe, fica até mais fácil dar manutenção, já que voce le o membro e já sabe exatamente do que se trata ou que ação ele realiza. Essa técnica vai em contradição ao que sempre achei certo, mas me rendi a utilização dos termos em portugues. Abaixo alguns membros que tenho atualmente no projeto em qual estou trabalhando:

namespace ArquivosDeBancos { … }
public int FatorDeVencimento { get; }
public class Repositorio<T> { … }
public string RelatoHtml { get; }
public enum TipoDeDocumento { … }
public Ocorrencia OcorrenciaDeRetorno { get; }

Mas ainda há um cenário onde ainda preciso manter o nome da classe com parte em ingles e parte em portugues. Isso ocorre quando preciso criar uma exceção ou um argumento customizado. Isso porque, por ser uma boa prática, a Microsoft sugere que sufixe as classes que herdam de Exception e EventArgs com […]Exception e […]EventArgs, respectivamente. Exemplo:

public class ProdutoNaoEncontradoException { … }
public class ExtraindoInformacoesEventArgs { … }

Já estou certo de que a nomenclatura dos membros e tipos em portugues sao a melhor opcao para a minha realidade.

Anúncios

Deixe uma resposta

Preencha os seus dados abaixo ou clique em um ícone para log in:

Logotipo do WordPress.com

Você está comentando utilizando sua conta WordPress.com. Sair / Alterar )

Imagem do Twitter

Você está comentando utilizando sua conta Twitter. Sair / Alterar )

Foto do Facebook

Você está comentando utilizando sua conta Facebook. Sair / Alterar )

Foto do Google+

Você está comentando utilizando sua conta Google+. Sair / Alterar )

Conectando a %s