Ya sea que esté iniciando un proyecto de software completamente nuevo o desee adoptar un enfoque de » Documentos como código » con su documentación en GitHub, uno de los primeros pasos es crear un repositorio (repositorio). Así es como se hace.
¿Por qué crear un repositorio de GitHub?
Git es un sistema de control de revisión distribuido de código abierto que permite a varios desarrolladores (¡ y escritores !) Realizar y realizar un seguimiento de los cambios en el código o la documentación de forma constante y consecutiva en una ubicación centralizada sin anular el trabajo de otra persona. Este control de versión hace que, si algo se rompe, pueda localizar fácilmente la fuente del problema y volver a una versión funcional antes de que se envíe el código problemático.
También es bueno para rastrear quién contribuyó a qué y cuándo. Esto es especialmente importante cuando varias personas de diferentes zonas horarias contribuyen a un proyecto.
Al crear un repositorio de GitHub, brinda estos beneficios a su proyecto. Además, si permite que su repositorio esté abierto al público, otros pueden contribuir, ya sea para corregir un código roto o incluso corregir errores tipográficos. Incluso es posible que pueda lanzar una versión beta funcional antes de lo programado. El código abierto es algo hermoso.
Cómo crear un repositorio de GitHub
Para configurar un proyecto en GitHub, deberá crear un repositorio. Para hacerlo, inicie sesión en (o cree ) su cuenta de GitHub. Una vez que haya iniciado sesión, haga clic en el icono «+» en el lado derecho del menú de encabezado (al que se puede acceder desde cualquier lugar del sitio). Seleccione «Nuevo repositorio» en el menú desplegable que aparece.
Ahora estará en la página «Crear un nuevo repositorio». Elija el propietario del repositorio y asígnele un nombre breve y memorable. Tenga en cuenta que el nombre del repositorio debe ser compatible con URL. Si bien no existe una convención estricta, la forma más popular es usar todas las letras minúsculas mientras separa las palabras con un guión, como example-repo-name. Si usa espacios en el nombre, se agregará un guión en su lugar.
Una vez que haya nombrado su repositorio, dele una breve descripción y elija si desea que el repositorio sea público o privado.
A continuación, puede:
- Agregue un archivo README : Presente y explique cómo usar y contribuir a su proyecto.
- Agregar .gitignore : elija qué archivos ignorar.
- Elija una licencia : deje que los demás sepan lo que pueden y no pueden hacer con el código de su proyecto.
Estos son opcionales pero se recomienda agregarlos. Cuando esté listo, haga clic en «Crear repositorio».
Su repositorio ahora está creado.
Una vez que haya creado un repositorio, puede clonarlo en su máquina local , lo que le permite editar el contenido localmente en lugar de hacerlo directamente en los archivos de origen del repositorio.
