Getting Started with GitHub

[github-learning-lab]

👋 Bienvenido a "Introducción a GitHub" de GitHub Learning Lab

Para empezar, te guiaré a través de unos primeros pasos que son importantes para programar y colaborar en GitHub.

👇 Esta flecha indica que puedes expandir la ventana! Haz clic en ellas durante el curso para más información.

¿Qué es GitHub?

---

¿Qué es GitHub?

¡Me alegra que lo hayas preguntado! Muchas personas usan GitHub porque quieren contribuir a proyectos de código abierto ^📖, o porque son invitados por compañeros de trabajo o de clase que usan GitHub en sus proyectos. ¿Por qué la gente usa GitHub en sus proyectos?

En esencia, GitHub es una plataforma de colaboración.

Desde software hasta documentos legales, puedes contar con GitHub para ayudarte a hacer tu mejor trabajo con las herramientas de colaboración y seguridad que tu equipo necesita. Con GitHub, puedes mantener proyectos completamente privados, invitar al mundo a colaborar y optimizar cada paso de tu proyecto.

GitHub también es una poderosa herramienta de versión de control.

GitHub usa Git ^📖, el software de control de versión más popular para rastrear cada contribución y colaborador ^📖 de tu proyecto--de esta manera sabrás exactamente de dónde vino cada línea de código de tu proyecto.

GitHub ayuda a las personas a hacer mucho más.

La gente usa GitHub para construir varias de las tecnologías más avanzadas del mundo. Ya sea que estes visualizando datos o construyendo un nuevo juego, hay una comunidad entera y un set de herramientas en GitHub que te puedan llevar al siguiente nivel. Este curso empieza con lo básico pero ¡profundizaremos el resto después!

📺 Video: ¿Qué es GitHub?

---

Explorando un repositorio de GitHub

---

Explorando un repositorio de GitHub

📺 Video: Explorando un repositorio

Más características

El video cubre algunas de las características usadas con mayor frecuencia. Aquí hay otras cosas que puedes encontrar en los repositorios de GitHub:

• Tableros para el proyecto: Crear un tablero estilo Kanban para seguir tus tareas dentro de GitHub
• Wiki: Crea y guarda documentación relevante acerca de tu proyecto.
• Estadísticas: Ve un menú desplegable que contiene enlaces a herramientas de análisis para tu repositorio, que incluyen:
  • Pulso: Encuentra información sobre el trabajo que ha sido completado y el trabajo que está en progreso en este panel del proyecto.
  • Gráficas: Las gráficas proporcionan una vista más granular de la actividad del repositorio, incluyendo quién contribuyó al repositorio, quién lo bifurcó y cuándo completaron el trabajo.

Archivos especiales

En el video aprendiste sobre un archivo especial llamado README.md. Aquí hay una lista de algunos otros archivos especiales que puedes añadir a tus repositorios:

• CONTRIBUTING.md: El archivo CONTRIBUTING.md es usado para describir el proceso para contribuir al repositorio. Un link al archivo CONTRIBUTING.md es mostrado cada vez que alguien crea una nueva propuesta o una solicitud de extracción.
• ISSUE_TEMPLATE.md: El archivo ISSUE_TEMPLATE.md lo puedes usar para rellenar el cuerpo de una propuesta. Por ejemplo, si siempre necesitas el mismo tipo de información para reportar errores puedes incluirlo en la plantilla de tu propuesta y cada nueva propuesta será abierta con el texto que has recomendado para empezar.

---

Usando las propuestas (o issues)

Esto es una propuesta (o issue) ^📖: un lugar en el que puedes tener conversaciones sobre los errores en tu código, revisiones de código y casi cualquier otra cosas que te puedas imaginar.

Los títulos de tus propuestas son como la línea de asunto de un email. Avisan de un vistazo a tus colaboradores de qué trata tu propuesta. Por ejemplo, el título de esta propuesta es Getting Started with GitHub.

Usando GitHub Issues (propuestas)

Usando propuestas de GitHub

Las propuestas se usan para discutir ideas, mejoras, tareas y errores. Facilitan la colaboración al:

• Proveer a todos (incluso miembros futuros) la historia completa en un solo lugar
• Permitirte entrelazar tu propuesta con otras propuestas o una solicitud de extracción (o pull request) ^📖
• Crear un registro único y completo de cómo y por qué tomaste ciertas decisiones
• Permitirte atraer fácilmente a las personas y los equipos adecuados a una conversación con @MENCION
  📺 Video: Usando propuestas

---

Administrando notificaciones

---

Administrando notificaciones

📺 Video: Observando, notificaciones, estrellas y explorar

Una vez que hayas comentado en una propuesta o solicitud de extracción, empezarás a recibir notificaciones por email cada vez que haya actividad en tu hilo.

Cómo silenciar o dejar de silenciar conversaciones en específico.

1. Ve a la propuesta o solicitud de extracción
2. Bajo "Notifications", haz clic en el botón de Unsubscribe a la derecha para silenciar notificaciones o Subscribe para dejar de silenciarlas.

Verás una descripción corta que explica tu estado actual de notificaciones.

Cómo personalizar notificaciones en Settings

1. Haz clic en el icono de tu perfil
2. Haz clic en Settings
3. Haz clic en Notifications desde el menú a tu izquierda y ajusta tus preferencias de notificaciones

Opciones de notificación de un repositorio

• Watch: Recibirás una notificación cuando una nueva propuesta, solicitud de extracción o comentario ha sido publicado y también cuando una propuesta ha sido cerrado o una solicitud de extracción ha sido fusionada.
• Not watching: No vas a recibir notificaciones al menos que te hayan mencionado usando @
• Ignore: No vas a recibir ningún tipo de notificación sobre este respoitorio

Cómo revisar las notificaciones de los repositorios que estás observando

1. Haz clic en tu icono de perfil
2. Haz clic en Settings
3. Haz clic en Notification desde el menú a tu izquierda
4. Haz clic en el link de repositorios que estás observando
5. Selecciona la pestaña Watching
6. Haz clic en el botón de Unwatch para inhabilitar las notificaciones o en Watch para habilitarlas.

---

---

Sigue leyendo a continuación para encontrar tu primera tarea

[github-learning-lab]

Paso 1: Asígnate

Las propuestas (issues) que no han sido asignadas no tienen a una persona que se encargue de ellas. Cuando te asignan una propuesta o solicitud de extracción, esto dice a visitantes y colaboradores de tu repositorio que tú vas a estar facilitando la conversación o la tarea.

⌨️ Actividad

1. En la parte derecha de tu pantalla, bajo la sección de "Assignees", haz clic en el icono de engranaje y selecciónate. También puedes hacer clic en "assign yourself".

Para una versión impresa de los pasos en este curso, revisa la Quick Reference Guide.

---

Responderé cuando haya detectado que te has asignado esta propuesta.

¡A veces respondo muy rápido, antes de que la página se actualice! Si ya realizaste la acción y no me ves responder, espera unos segundos y actualiza la página para mostrar los siguientes pasos.