A princípio isso pode parecer uma tarefa para os 'experts' mas na verdade um código limpo e fácil de entender pode ser feito a partir de regras simples.

A seguir vou apresentar algumas regras básicas de padronização de codificação que podem ser seguidas e usadas por programadores de qualquer nível de conhecimento.

Code Smell (Um código que fede)

Code Smell (Um código que cheira, fede) é uma palavra técnica usada para descrever a qualidade do código - como um programador escreve este código, sendo também utilizada para descrever o código que você não gosta. Nesse sentido, é sinônimo de feio, sujo, repetido, etc.
 
Um código que cheira é um código ruim mas que nem por isso deixa de funcionar e por isso mesmo ele é difícil de entender e de manter. Abaixo temos alguns motivos que fazem com que um código seja definido como um código que fede:

- Código duplicado
- Métodos muito grandes
- Classes com muitas variáveis ​​de instância
- Classes com muito código

Agora, vamos ver como podemos escrever um código limpo e evitar esses cheiros no programa. A maneira mais fácil e simples e começar pela norma básica de codificação, ou seja, pela convenção da nomenclatura.

Enquanto estamos codificando, vamos nos concentrar em nosso padrão de nomenclatura usada.  Existem 2 tipos principais de padrões de nomenclatura que estamos usando nos dias de hoje.

1. Pascal Casing
   Uma palavra com a primeira letra maiúscula, e a primeira letra de cada palavra-parte subseqüente capitalizada.
   Ex - CalculaImpostoDeRenda(), ValorDoDesconto
    
2. Camel Casing
   Uma palavra com a primeira letra minúscula e a primeira letra de cada palavra subseqüente-parte capitalizada.
   Ex: valorDoDesconto , nomeCompleto, valorDoImpostoSobreServico

A seguir veremos como aplicar esses padrões de forma correta para ter um código limpo.

1 - Ao nomear uma classe e seus métodos utilize o padrão Pascal Case

    public class FuncionariosDetalhes
    {
        public void GetSalarioFuncionario()
        {
            //código
        }
    }

2 - Ao nomear variáveis e parâmetros utilize padrão Camel Case

    public class FuncionariosDetalhes
    {
        private double salarioTotal = 0;
        private double descontoImposto = 0;

        public void GetSalarioFuncionario()
        {
            int valor = 3000;
        }
    }

3 - Ao utilizar Interfaces sempre use como prefixo inicial a letra "I" e depois siga o padrão Pascal Case

    interface ICalculoDescontoSobreSalario
    {
        void GetValorAdiamento();
        double GetPercentualImposto();
    }

4 - Ao nomear classes, métodos, variáveis e interfaces utilize nomes significativos que sejam auto descritivos e pertinentes ao seu propósito

Vamos comparar dois exemplos de trechos de códigos onde no primeiro temos um código sujo e no segundo um código limpo:

public class Funcionario  {    public void GetValor(double s, double he, double d)    {       int t = s + he - d;   } }

public class CalculoSalarioFuncionario   {      /// <summary>      /// Calcula o valor do salário de um funcionário horista      /// </summary>      /// <param name="salario"></param>                       /// <param name="horaExtra"></param>      /// <param name="desconto"></param>     public void GetValorSalario(int salario, int horaExtra, int desconto)      {          int valorTotalSalario = salario + horaExtra - desconto;      } }

Qual dos dois trechos de código é mais fácil de entender ?

• Sempre utilize nomes descritivos para as variáveis:   salario e não s, horaExtra e não he, desconto e não d ;
• Ao nomear métodos utilize nomes que descrevam o propósito do método :  :   GetValorSalario() e não GetValor() ;
• Se for necessário comente o método descrevendo o seu propósito e seus parâmetros de forma resumida;

5 - Não utilize métodos longos, mas, se isso for realmente necessário use o recurso Region para facilitar a leitura do método

No código abaixo temos um método mais longo que pode se tornar difícil de ler e entender :

Aplicando o recurso Region ao código podemos recolher o código para ter uma visão geral do método facilitando o entendimento do código: