Guía para principiantes sobre repositorios de GitHub: Cómo crear tu primer repositorio

Comienza con tu primer repositorio en la tercera entrega de GitHub para principiantes. Descubre las funciones y configuraciones esenciales para gestionar tus proyectos de manera efectiva.

Autora: Kedasha Kerr

Bienvenidos de nuevo a GitHub para principiantes, una serie diseñada para ayudarte a navegar por GitHub con facilidad.

En nuestra última publicación, cubrimos los principales comandos de Git que todo desarrollador debe conocer. Hoy, vamos a adentrarnos en el corazón de GitHub: ¡los repositorios! Qué son, cómo crear uno, todas sus funciones y configuraciones, y más.

Ya seas desarrollador, escritor o simplemente curioso sobre el control de versiones, entender los repositorios es tu primer paso en el mundo de GitHub.

Entonces, digamos que ya creaste tu cuenta de GitHub. ¿Qué sigue? Vamos a comenzar desde el principio.

¿Qué es un repositorio?

Un repositorio, o repo, es un elemento fundamental de GitHub y Git. Es un espacio donde se almacenan los archivos de un proyecto, lo que permite el control de versiones y la colaboración.

Puedes pensar en un repositorio como una carpeta de proyecto que rastrea cambios, almacena historial y permite que varias personas trabajen juntas sin problemas.

¿Cómo creo un repositorio?

Después de crear una cuenta en GitHub, serás llevado a tu nuevo panel de control de GitHub. Deberías ver un botón verde que dice “Crear repositorio”.

Al hacer clic en este botón, serás dirigido a la página "Nuevo repositorio", donde puedes ingresar el nombre del repositorio, seleccionar un propietario del repositorio (tú, en este caso), agregar una descripción sobre tu proyecto y elegir si el proyecto será público o privado.

Desde aquí, puedes inicializar tu proyecto con un README.

¿Qué es un README?

Un archivo README en un repositorio de GitHub proporciona información esencial sobre el proyecto, incluyendo su propósito, instrucciones de uso, cómo empezar, dónde encontrar ayuda y detalles sobre los colaboradores. Sirve como una guía introductoria para los visitantes, ayudándoles a entender y utilizar el proyecto de manera efectiva. Por ahora, marca la casilla para agregar un README.

Es probable que no necesites un archivo .gitignore para este proyecto (hablaremos más de eso más adelante), así que selecciona "Ninguno". Luego, debajo de "Elegir una licencia", puedes seleccionar la Licencia MIT de la lista.

Una vez que hayas terminado con eso, haz clic en el botón verde "Crear repositorio". ¡Acabas de crear tu primer repositorio en GitHub!

¿Cómo elijo una licencia para mi repositorio?

Una licencia le dice a otros lo que pueden y no pueden hacer con tu código fuente. Generalmente, se utiliza para compartir código con otros, lo que se conoce como software de código abierto. Esto significa que, según la licencia que elijas, cualquier persona en Internet puede tomar tu código y utilizarlo.

Por ejemplo, seleccionaste una Licencia MIT para el repositorio que acabas de crear. Esta es conocida como una "licencia permisiva", que permite a cualquiera utilizar tu código como quiera.

Elegir la licencia adecuada es esencial para establecer los términos bajo los cuales otros pueden usar, modificar y compartir tu proyecto. Tómate tu tiempo para elegir la correcta.

Puedes aprender más sobre licencias y cómo elegir la adecuada visitando choosealicense.com.

¿Cómo hago un fork de un repositorio?

Un gif animado que muestra cómo hacer un fork de un repositorio, comenzando por hacer clic en el ícono de "Fork", luego nombrando el fork y finalmente haciendo clic en el botón "Crear fork".

Hacer un fork es otra forma de crear un repositorio, pero esta vez no empiezas desde cero. Un fork esencialmente crea una copia de un repositorio existente, para que tengas tu propia versión para trabajar y modificar a tu gusto.

Por ejemplo, cuando quieres contribuir a un proyecto de código abierto, primero necesitas hacer un fork del repositorio y luego trabajar desde allí.

Por eso es muy importante elegir la licencia correcta, para que otros conozcan las limitaciones de lo que pueden hacer con tu código.

¿Qué es .gitignore?

Finalmente, tenemos la opción de "agregar .gitignore" en la página del nuevo repositorio. gitignore.io es un archivo que se usa en ciertos proyectos si deseas que Git ignore o no rastree ciertos archivos en tu repositorio.

La exclusión de archivos a veces se basa en los lenguajes, marcos de trabajo y otras tecnologías que estés utilizando.

Puedes visitar gitignore.io para generar un archivo .gitignore basado en las necesidades de tu proyecto.

¿Cuáles son las principales características de un repositorio de GitHub?

Ahora que has creado tu primer repositorio, es hora de familiarizarte con algunas de sus características principales.

La barra de funciones superior de un repositorio de GitHub. Las funciones, que incluyen "Issues, Pull Requests, Actions, Projects, Wiki, Security, Insights", están resaltadas con un rectángulo delineado en rojo.

Los repositorios de GitHub están repletos de características para mejorar la colaboración y la gestión de proyectos, incluyendo:

• Issues: rastrear errores o tareas.

• Projects: organizar tareas en tableros estilo Kanban.

• Pull requests: fusionar cambios desde diferentes ramas o forks.

• Wikis: crear documentación detallada.

Configuración del repositorio

La página "Configuración" para un repositorio de GitHub.

En la configuración del repositorio, puedes gestionar:

• Colaboradores: agregar miembros del equipo a tu proyecto.

• Automatización: configurar acciones para integración o despliegue continuo.

• Seguridad: configurar ajustes de seguridad y controles de acceso.

Aquí también es donde puedes habilitar y deshabilitar funciones del repositorio.

Tus próximos pasos con los repositorios de GitHub

Ahora entiendes los conceptos básicos para crear y gestionar un repositorio en GitHub. Con tu primer repositorio configurado, ¡ya estás listo para explorar sus características y comenzar a colaborar en tus proyectos!

Si tienes alguna pregunta, publícala en el hilo de la Comunidad GitHub y nos aseguraremos de responder.

Aquí hay algunos recursos adicionales para ayudarte en tu viaje por GitHub:

• Certificado de Fundamentos de GitHub

• Mejores prácticas para repositorios

• Hacer un fork de un repositorio

• Crear un nuevo repositorio