Skip to main content

Procedimientos recomendados para repositorios

Aprende a usar repositorios de forma más eficaz.

Creación de una archivo LÉAME

Para facilitar que los usuarios comprendan el trabajo y naveguen por él, se recomienda crear un archivo LÉAME para cada repositorio.

Puedes agregar un archivo README a un repositorio para comunicar información importante sobre tu proyecto. Un archivo LÉAME, junto con una licencia de repositorio, un archivo de cita, instrucciones de contribución y un código de conducta, comunica las expectativas de tu proyecto y te ayuda a administrar las contribuciones. Para más información, consulta "Acerca de los archivos README".

Favorecer la ramificación por encima de la bifurcación

Para simplificar la colaboración, se recomienda que los colaboradores habituales trabajen desde un único repositorio, creando solicitudes de incorporación de cambios entre ramas en lugar de entre repositorios. La bifurcación es más adecuada para aceptar contribuciones de personas que no están afiliadas a un proyecto, como colaboradores de código abierto.

Para mantener la calidad de las ramas importantes, como main, mientras se usa un flujo de trabajo de ramificación, puedes usar ramas protegidas con comprobaciones de estado necesarias y revisiones de solicitudes de incorporación de cambios. Para obtener más información, vea «Acerca de las ramas protegidas».

Use Almacenamiento de archivos de gran tamaño de Git

Para optimizar el rendimiento, GitHub.com limita los tamaños de los archivos permitidos en los repositorios. Para obtener más información, vea «Acerca de los archivos grandes en GitHub».

Para realizar un seguimiento de archivos grandes en un repositorio de Git, se recomienda usar Almacenamiento de archivos de gran tamaño de Git (Git LFS). Para obtener más información, vea «Acerca de Large File Storage de Git».