Getting Started with GitHub
github-learning-lab opened this issue · 4 comments
👋 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!
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.mdes usado para describir el proceso para contribuir al repositorio. Un link al archivoCONTRIBUTING.mdes mostrado cada vez que alguien crea una nueva propuesta o una solicitud de extracción. - ISSUE_TEMPLATE.md: El archivo
ISSUE_TEMPLATE.mdlo 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.
- Ve a la propuesta o solicitud de extracción
- 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
- Haz clic en el icono de tu perfil
- Haz clic en Settings
- 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
- Haz clic en tu icono de perfil
- Haz clic en Settings
- Haz clic en Notification desde el menú a tu izquierda
- Haz clic en el link de repositorios que estás observando
- Selecciona la pestaña Watching
- 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
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
- 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.
Paso 2: Activa GitHub Pages
🎉 ¡Ahora eres quien supervisa 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 al cargo 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, pero el sitio aún no es visible. Cambiemos eso.
⌨️ Actividad: Habilita GitHub Pages
- Haz clic en la pestaña Settings de este repositorio
- Navega a la sección de GitHub Pages
- En la lista llamada "Source" selecciona main 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 ha 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.
Paso 3: Cierra una propuesta
¡Haz activado GitHub Pages!
Ahora tu sitio es visible para el público. Compruébalo en https://egarciahz.github.io/github-slideshow/.
Ahora que ya completaste las tareas en esta propuesta, ¡es hora de cerrarla! Cerrar una propuesta les dice al resto de colaboradores que esta conversación o tarea en particular ha sido completada.
⌨️ Actividad
- Haz clic en el botón de Close issue aquí abajo