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 click 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 frequencia. 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 documetació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 prellenar el cuerpo de una propuesta. Por ejemplo, si siempres 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

Esto es una propuesta ^📖: 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 sujeto de un email. Avisan de un vistazo a tus colaboradores de que 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) con la historia completa en un solo lugar
• Permitirte entrelazar tu propuesta con otras propuestas o una solicitud de extracción ^📖
• 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 @Mención
  📺 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 click 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 click en el ícono de tu perfil
2. Haz click en Settings
3. Haz click 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 click en tu ícono de perfil
2. Haz click en Settings
3. Haz click en Notification desde el menú a tu izquierda
4. Haz click en el link de repositorios que estás observando
5. Selecciona la pestaña Watching
6. Haz click 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 dueños que se encarguen de ellas. Cuando te asignan una propuesta o solicitud de extracción, esto les dice a los 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 click en el ícono de engrane y seleccionate.

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

---

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

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

[github-learning-lab]

Paso 2: Activa GitHub Pages

🎉 ¡Ahora eres el supervisor de esta propuesta! Ahora que te has autodesignado, las personas que vean tu propuesta sabrán que su participación es bienvenida, pero tú estás encargado(a) de llevar esta propuesta hasta el punto final 😎.

Usemos GitHub Pages

¡Ahora a lo que venimos! GitHub Pages te permite servir un sitio estático basado en un repositorio. Hemos llenado este repositorio con contenido de sitio, pero el sitio aún no es visible. Cambiemos eso.

⌨️ Actividad: Habilita GitHub Pages

1. Haz click en la pestaña Settings de este repositorio
2. Navega a la sección de GitHub Pages
3. En la lista llamada "Source" selecciona master branch

Nota: Aunque puedes ver una opción para escoger un tema, no apliques ningún tema en este momento. Hemos protegido el código para que no puedas hacer cambios involuntarios. Tendrás oportunidad de usar un tema cuando terminemos el curso.

---

Responderé en esta propuesta cuando detecte que GitHub Pages haya implementado tu página .

Activar GitHub Pages crea una implementación de tu repositorio. Me podré tomar hasta un minuto para responder mientras espero que la implementación termine.

[github-learning-lab]

Paso 3: Cierra una propuesta

¡Haz activado GitHub Pages!

Ahora tu sitio es visible para el público. Chécalo en .

Ahora que ya completaste las tareas en esta propuesta, ¡es hora de cerrarla! Cerrar una propuesta le dice a los otros colaboradores que esta conversación o tarea en particular ha sido completada.

⌨️ Actividad

1. Haz click en el botón de Close issue aquí abajo

---

Responderé cuando hayas cerrado esta propuesta.

[github-learning-lab]

¡Considera esta propuesta terminada! ✅

---

Navega a la siguiente propuesta ahora!