Skip to content

Files

Latest commit

 

History

History

Capitulo_5

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 

Capítulo 5

Neste capítulo o autor ressalta a importância de uma boa formatação para um código limpo, um código bem formatada de primeira vista é agradável.

Principais tópicos

  • O objetivo da formatação
  • Formatação vertical
  • Espaçamento vertical entre conceitos
  • Continuidade vertical
  • Distância vertical
  • Ordenação vertical
  • Formatação horizontal
  • Espaçamento e continuidade horizontal
  • Alinhamento horizontal

O objetivo da formatação

A formatação vai ser a primeira mensagem que o seu código irá passar, um código mal formatado é péssimo de olhar e de ler.

Formatação vertical

A formatação vertical vai retratar sobre o tamanho do seu código, arquivos com centenas ou milhares de linha requerem uma linearidade para se facilitar o seu entendimento, caso o contrário, o leitor do seu código irá ter muito trabalho.

Espaçamento vertical entre conceitos

Um código sem quebra de linha, com um amontoado de palavras compactadas pode tornar o código difícil de ler, quando há quebra de linha separando conceitos como funções separadas de outras funções ou declaração/instanciação de variáveis torna o código mais legível.

Continuidade vertical

Como dito antes, a instaciação ou declaração de variáveis juntas cria um nível de entendimento maior.

Distância vertical

A separação vertical dos conceitos é muito importante para a garantia de uma boa leitura de código.

Declaração de váriáveis

As variáveis devem ser declaradas o mais próximo possível de onde serão usadas, por exemplo, em funções devemos declará-las no topo do escopo da função.

Instanciação de variáveis

Devem ser declaradas no início da classe

Funções dependentes

Uma função que chama outra função deve ficar próxima verticalmente a função que irá ser chamada, isso dá um bom fluxo no código.

Ordenação vertical

De modo geral queremos que as chamadas das dependências sejam ordenadas, isto é, a função que será chamada fique acima da função que irá chama-lá (Conceitos vem primeiro).

Formatação horizontal

Os tamanhos de linhas importam, um código com linhas de 80 caracteres são difíceis de ler, pois necessita de scroll lateral para ser lido.

Espaçamento e continuidade horizontal

Os principais motivos de se utilizar o espaçamento horizontal é para dar destaque e/ou desassociar coisas fracamente relacionadas.