Alinhamento vertical: sim ou não? [fechadas]

Por exemplo, alinhado não verticalmente:

Name:   Hamt
Version:  0.1.0
Cabal-Version:  >= 1.2
License:  BSD3
Author:  Jason Baker

Ou alinhado verticalmente:

Name:           Hamt
Version:        0.1.0
Cabal-Version:  >= 1.2
License:        BSD3
Author:         Jason Baker

Qual você prefere e por quê?

Pessoalmente, sou da opinião de que a segunda versão do código é marginalmente mais legível, mas não acho que mantê-lo compensa essa legibilidade. Portanto, eu usaria a segunda versão deste exemplo apenas se tivesse certeza de que o código não mudaria.

Economiza tempo quando você faz assim:

Name: Hamt
Version: 0.1.0
Cabal-Version: >= 1.2
License: BSD3
Author: Jason Baker

Também não é muito difícil de ler.

Eu prefiro um híbrido:

Name    : Hamt
Version : 0.1.0
Cabal-Version :  >= 1.2
License : BSD3
Author  : Jason Baker

Que é essencialmente o número 2, com exceções para linhas ocasionais que são mais longas que as linhas adjacentes - para impedir que a maioria das linhas seja espaçada muito acima.

Aqui está outra variação para layouts de lista com base na experiência e na educação de um curso universitário que fiz em interação humano-computador e em vários livros que li sobre o design de interface do usuário (G) e design gráfico. Eu o uso para diálogos, e quando tenho energia / tempo, para CSS (normalmente não para código).

          Name : Hamt
       Version : 0.1.0
 Cabal-Version : >= 1.2
       License : BSD3
        Author : Jason Baker

Como todos os outros, tem seus prós e contras.

Prós:

• Forte quebra visual separa os dados dos rótulos
• Aparência de design gráfico profissional esteticamente agradável (principalmente para arquivos publicados finalizados)
• Os dados estão mais próximos do rótulo, facilitando a associação (diminui as chances de ler através de uma linha os dados incorretos)
• Ideal para layouts de caixas de diálogo

Contras:

• Requer mais tempo para formatar corretamente
• Requer realinhamento quando um novo item mais longo é adicionado
• Não é tão útil para código

HTH

Eu prefiro o primeiro, mas sem as abas (que acho que são os espaços em branco); apenas um espaço em branco. Para mim, é mais fácil ler quando os dados não são "semelhantes", como no caso especificado. Também torna mais difícil (ao editar esses dados) "interpretar mal uma linha", ou seja, quando você tem três linhas com, digamos, números de versão. E depois, ao editar um, você acidentalmente edita outro no lugar.

Quando os dados são semelhantes, no entanto, faz todo o sentido colocá-los em colunas, como no seu segundo exemplo (só que não são semelhantes, mas você entendeu).

Infelizmente, sendo uma questão de estilo, isso é muito subjetivo e você provavelmente terá muitos resultados conflitantes. Além disso, o estilo a ser usado depende muito do uso de TABs ou espaços.


Quanto aos meus dois centavos, prefiro uma variação da segunda versão. Eu gosto mais disso:

Name            : Hamt
Version         : 0.1.0
Cabal-Version   : >= 1.2
License         : BSD3
Author          : Jason Baker

É a versão mais legível e fácil de usar que eu tentei. A única desvantagem real é que eu tenho que descobrir qual é o campo mais amplo e, às vezes, acabo tendo que expandir todos eles quando um é muito amplo (isso geralmente acontece apenas com CSS). No entanto, existem alguns pontos que precisam ser considerados.

Primeiro, eu normalmente prefiro TABs em vez de espaços, no entanto, a configuração real do TAB varia; por exemplo, estou acostumado a TABs de 4 espaços para código C (++) ou HTML e TABs de 2 espaços para código Pascal ou Assembler, enquanto que para algumas coisas como CSS, não tenho preferência pela largura da TAB. Essa variação complica bastante as coisas, mas o editor que eu uso lança suas próprias complicações. Alguns editores permitem definir configurações de TAB por idioma, mas outros não (mesmo alguns que têm perfis diferentes).

Você pode evitar essa complicação renunciando às TABs em favor dos espaços. Como o código geralmente está em uma fonte de largura fixa, o uso de espaços funciona bem, enquanto se você estiver formatando campos em um formulário, resumo ou outro texto que não seja de código e estiver usando uma fonte proporcional, precisará de TABs para manter as coisas alinhadas .

Prefiro TABs em geral, porque mesmo com código de largura fixa, acho frustrante ter que percorrer vários espaços para cada TAB. Lembro-me de que os antigos IDEs da Borland tinham a opção de percorrer as TABs (especificamente comprimentos inteiros de espaço em branco) como uma única entidade, em vez de dois, quatro, etc. Isso tornou prático inserir TABs como espaços, além de tornar a navegação do cursor fácil e rápida. Infelizmente, eu não vi nenhum editor moderno do Windows que possa fazer isso.

Por fim, o fato de outras pessoas usarem seu código ou não desempenha um grande fator na escolha do estilo. Normalmente sou o único que usa meu código, para que eu possa formatar tudo de acordo com o meu gosto, sem levar em consideração os editores ou configurações de outros. Se você estiver trabalhando com outras pessoas, precisará considerá-las, pois elas deverão considerá-lo.


Em resumo, a legibilidade é boa e muito desejável, no entanto, as configurações e editores que você e outras pessoas que precisam usar o código serão importantes ao tomar a decisão. Se você estiver sozinho, também poderá usar o formato mais legível. Talvez você precise se acostumar a usá-lo, mas provavelmente será recompensado a longo prazo, especialmente quando você precisar voltar ao código que escreveu há algum tempo: a legibilidade é tão importante quanto os comentários para entender o que o código faz. Se você trabalha com outras pessoas, precisará trabalhar em conjunto para definir algum tipo de guia de design para uso da equipe.