Acabo de bifurcar un proyecto en Github, hice mis cambios, etc. Esto me hizo preguntarme: veo principalmente README.txt en proyectos de código abierto y el archivo que edité fue Readme.txt. ¿Es esto algún tipo de estandarización o debería haberlo dejado como está?
naming-standards
Tolga Ozses
fuente
fuente
Respuestas:
Las letras mayúsculas destacan y hacen que el archivo sea fácilmente visible, lo que tiene sentido porque es probablemente lo primero que un nuevo usuario desearía mirar. (O, al menos, debería haber mirado ...) Como ya han dicho otros, los nombres de archivo que comienzan con una letra mayúscula se enumerarán antes de los nombres en minúsculas en la clasificación ASCIIbetical (
LC_COLLATE=C
) que ayuda a hacer que el archivo sea visible a primera vista.El
README
archivo es parte de un montón de archivos que un usuario de un paquete de software libre normalmente esperaría encontrar. Otros sonINSTALL
(instrucciones para construir e instalar el software),AUTHORS
(lista de contribuyentes),COPYING
(texto de la licencia),HACKING
(cómo comenzar a contribuir, tal vez incluyendo una lista TODO de puntos de partida),NEWS
(cambios recientes) oChangeLog
(en su mayoría redundantes con sistemas de control de versiones).Esto es lo que los estándares de codificación GNU tienen que decir sobre el
README
archivo.Como siempre es bueno tratar de sorprender a sus usuarios, debe seguir esta convención a menos que existan razones convincentes para una desviación. En el mundo UNIX, las extensiones de nombre de archivo se usaban tradicionalmente con moderación, por lo que el nombre canónico del archivo
README
no tiene sufijo. Pero la mayoría de los usuarios probablemente no tendrían problemas para entender que un archivo llamadoREADME.txt
tiene el mismo significado. Si el archivo está escrito en Markdown , un nombre de archivo comoREADME.md
también podría ser razonable. Evite usar lenguajes de marcado más complicados como HTML en elREADME
archivo, sin embargo, porque debería ser conveniente leer en un terminal de solo texto. Puede indicar a los usuarios el manual del software o su documentación en línea, que podría estar escrita en un formato más sofisticado, para obtener detalles delREADME
archivo.fuente
Tradicionalmente, el archivo se llamaba README en mayúsculas porque los entornos de línea de comandos que utilizan el orden alfabético colocarían el archivo en la parte superior. Esto los hace fácilmente visibles en grandes directorios.
Es muy probable que sea un remanente del mundo Unix / Linux donde descargaría fuentes y luego crearía su software. Tener archivos como README e INSTALL en la parte superior de la vista 'lista de contenidos del directorio' hace que sea más fácil ver que están allí, en lugar de tener que navegar por todo el contenido desde una interfaz de línea de comandos. El mismo principio básico también funciona para github (y en realidad también funciona en las interfaces GUI, ahora que lo pienso, por lo que aún podría tener mérito)
De ninguna manera es una regla difícil, pero muy probablemente es algo que todos están haciendo como hábito porque otros proyectos lo están haciendo. A menos que haya alguna razón explícita para NO hacerlo, probablemente debería usar mayúsculas solo porque verá que se usa de esa manera en muchos otros proyectos. También es el nombre predeterminado que utiliza Github cuando crea un nuevo repositorio.
fuente
ls -l | less
.README generalmente se escribe en mayúsculas. De esta manera, el
ls
comando Unix colocó el archivo cerca del comienzo de la lista del directorio (las letras mayúsculas van antes que las minúsculas en el orden ASCII).fuente
ls
generalmente no se ordena de esa manera en los sistemas modernos.LC_COLLATE="en_US.ascii" ; ls -l
vsLC_COLLATE="en_US.UTF-8" ; ls -l
)