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 está?
naming-standards
Tolga Ozses
fonte
fonte
Respostas:
As letras maiúsculas se destacam e tornam o arquivo facilmente visível, o que faz sentido, porque é provavelmente a primeira coisa que um novo usuário gostaria de ver. (Ou, pelo menos, deveria ter olhado para…) Como já foi dito, os nomes de arquivos iniciados com uma letra maiúscula serão listados antes dos nomes em minúsculas na classificação ASCIIbetics (
LC_COLLATE=C
), o que ajuda a tornar o arquivo visível à primeira vista.O
README
arquivo faz parte de vários arquivos que um usuário de um pacote de software livre normalmente esperaria encontrar. Outras sãoINSTALL
(instruções para compilar e instalar o software),AUTHORS
(lista de colaboradores),COPYING
(texto da licença),HACKING
(como começar a contribuir, talvez incluindo uma lista TODO de pontos de partida),NEWS
(alterações recentes) ouChangeLog
(principalmente redundantes com sistemas de controle de versão).É o que os Padrões de Codificação GNU têm a dizer sobre o
README
arquivo.Como é sempre bom procurar a menor surpresa de seus usuários, você deve seguir esta convenção, a menos que haja razões convincentes para um desvio. No mundo UNIX, as extensões de nome de arquivo eram tradicionalmente usadas com moderação, de modo que o nome canônico do arquivo não possui
README
sufixo. Mas a maioria dos usuários provavelmente não teria problemas para entender que um arquivo chamadoREADME.txt
tem o mesmo significado. Se o arquivo estiver escrito no Markdown , um nome de arquivo comoREADME.md
também pode ser razoável. Evite usar linguagens de marcação mais complicadas, como HTML, noREADME
arquivo, no entanto, porque deve ser conveniente ler em um terminal somente de texto. Você pode indicar aos usuários o manual do software ou a documentação on-line, que pode ser escrita em um formato mais sofisticado, para obter detalhes doREADME
arquivo.fonte
Tradicionalmente, o arquivo era chamado README em maiúsculas, porque os ambientes de linha de comando que usam a ordem alfabética colocavam o arquivo no topo. Isso os torna facilmente visíveis em grandes diretórios.
É muito provável que haja uma retração do mundo Unix / Linux, onde você faria o download de fontes e, em seguida, construiria seu software. Ter arquivos como README e INSTALL na parte superior da visualização 'list directory contents' facilita a visualização de que eles estão lá, em vez de ter que procurar todo o conteúdo em uma interface da linha de comandos. O mesmo princípio básico também funciona para o github (e na verdade também funciona em interfaces GUI, pense nisso, para que ainda tenha mérito).
De maneira alguma uma regra difícil, mas muito provavelmente algo que todo mundo está fazendo como um hábito, porque outros projetos estão fazendo isso. A menos que haja alguma razão explícita para NÃO, você provavelmente deve usar todos os limites apenas porque verá isso sendo usado dessa maneira em muitos outros projetos. É também a nomeação padrão que o Github usa quando você cria um novo repositório.
fonte
ls -l | less
.O README geralmente é escrito em maiúsculas. Dessa maneira, o
ls
comando Unix colocou o arquivo próximo ao início da lista de diretórios (as letras maiúsculas vêm antes das letras minúsculas na ordem ASCII).fonte
ls
normalmente não é assim nos sistemas modernos.LC_COLLATE="en_US.ascii" ; ls -l
vsLC_COLLATE="en_US.UTF-8" ; ls -l
)