Cómo usar GitHub

GitHub es un servicio en línea que puede utilizar para alojar el código de sus proyectos y controlar cuidadosamente las adiciones, cambios y ajustes. GitHub permite que otras personas colaboren en sus proyectos mientras le brinda las herramientas para que usted controle o limite cuidadosamente esas contribuciones. La plataforma también le brinda fácil acceso al historial de versiones y la capacidad de revertir los cambios.

La columna vertebral de GitHub es una tecnología de control de versiones llamada Git. Con Git, tiene un repositorio de código en el que vive su proyecto y realiza adiciones incrementales llamadas confirmaciones, con la capacidad de retroceder según sea necesario a las confirmaciones anteriores. Además, Git permite la ramificación, lo que es útil para trabajar en diferentes partes de un proyecto por separado.

GitHub aprovecha el poder de Git combinado con un modelo web de software como servicio (SaaS): es una de las plataformas web más utilizadas para colaborar en proyectos de desarrollo y uno de los mejores servicios de alojamiento de repositorios de Git.

En este tutorial, explicaremos cómo usar GitHub, aprendiendo cómo contribuir a los proyectos de otras personas y cómo crear y administrar los suyos propios.

Precios de GitHub: GitHub es de uso gratuito, con proyectos públicos y privados ilimitados. Las cuentas gratuitas solo permiten tres colaboradores en proyectos privados. Una cuenta Developer Pro por $ 7 / mes permite colaboradores ilimitados, así como herramientas de seguimiento avanzadas y gráficos de información sobre contribuciones y contribuyentes a sus proyectos.

Glosario de términos de GitHub

• Git: Git es un sistema de control de versiones que permite compartir una base de código completa entre colaboradores y que los desarrolladores de un proyecto creen, etiqueten y hagan referencia a pequeños lotes de cambios.

• Repositorio: En Git, un repositorio es el ./git carpeta, que almacena un historial de todos los cambios en los archivos de su proyecto. En GitHub, el término es más amplio e incluye su proyecto (incluido el ./git carpeta) y todos sus archivos y directorios.

• Rama: Una rama es un puntero a una confirmación. En términos sencillos, una rama de un repositorio proporciona una copia separada de la base de código, donde puede, por ejemplo, desarrollar una característica particular de forma aislada antes de fusionarla, aumentando la base de código para que la utilicen otros cuando esté completa.

• Cometer: Git commit es un comando que guarda los cambios en el código base con un mensaje descriptivo. Cada confirmación es típicamente un pequeño subconjunto de cambios.

• Asunto: Usted, o uno de los usuarios de su repositorio, crea un problema cuando encuentra un problema con el código en el repositorio. Los problemas también pueden ser una forma de realizar un seguimiento de las tareas a realizar.

• Solicitud de extracción: Una solicitud de extracción se produce cuando un colaborador realiza cambios en una rama y luego desea fusionarla de nuevo con la rama maestra. La solicitud de extracción permite comparar los cambios entre dos ramas, para la resolución de conflictos y para que otros revisen y aprueben los cambios antes de que los revisores los fusionen.

Cómo configurar su cuenta de GitHub

Una vez que se haya registrado para obtener una cuenta de GitHub, eche un vistazo rápido a su perfil y configuración. Para comenzar, haga clic en el menú desplegable en la esquina superior derecha y seleccione Ajustes.

Aquí hay algunas cosas de las que quizás desee ocuparse antes de comenzar a trabajar en la plataforma:

• La primera pestaña es la Perfil sección. Esta es la información básica del perfil público: un nombre para mostrar, una breve biografía, una imagen y otros campos similares.

• La Cuenta y Seguridad Las secciones contienen la configuración de cambio de nombre de usuario y contraseña, así como la configuración para la autenticación de dos factores.

• Notificaciones Es importante verificarlo, ya que GitHub tiene la capacidad de enviarle muchas notificaciones, y es posible que desee reducirlas de forma predeterminada.

• La Facturación La sección es donde puede comprar y administrar suscripciones para planes pagos.

• Claves SSH y GPG es importante si está usando Git en su línea de comando (o usando un programa como GitKraken o Tower) para acceder a su repositorio de GitHub.

Cómo buscar en GitHub

La funcionalidad de búsqueda de GitHub le permite hacer dos cosas distintas:

• Busque información en la plataforma en cualquier repositorio público (o privado al que tenga acceso)

• Buscar detalles dentro de un repositorio elegido

Cuando comienzas a escribir en la barra de búsqueda, un menú desplegable te da la opción de buscar en el repositorio actual o en todo GitHub. También le brinda opciones de otros repositorios suyos y tableros de tareas para buscar.

Al buscar en la plataforma GitHub, puede usar filtros para buscar solo (o excluir) problemas o RP etiquetados con etiquetas específicas. Consejo profesional: muchos repositorios tienen etiquetas llamadas help wanted o good first issue. Las personas que desean colaborar buscan estas etiquetas para encontrar problemas que abordar. También puede filtrar por tipo de resultado (RP vs. problema vs. código), por el estado de un RP, por autor y más.

Para obtener más información sobre los modificadores de búsqueda que puede usar al buscar en GitHub, consulte la documentación de GitHub.

Cómo contribuir a proyectos en GitHub

Cuanto más hagas en GitHub, más fuerte se volverá tu perfil, además de la experiencia práctica que adquieres mientras trabajas en proyectos de código abierto.

Mientras busca proyectos en los que contribuir, una de las primeras cosas que debe hacer es inspeccionar los archivos READMEs. README.md suele ser el primer archivo creado en un repositorio, con el propósito de ser una introducción y, a veces, un índice, por lo que le da una idea rápida de para qué sirve un repositorio. El archivo README está ahí cuando abre un repositorio, justo debajo de la lista de archivos.

A menudo, también hay una guía CONTRIBUTING.md, otro archivo que detalla el proceso de contribución al repositorio. Esto puede incluir información importante sobre el estilo o el proceso, así que si hay uno, asegúrese de verificarlo: algunos proyectos no aceptarán solicitudes de extracción y contribuciones si el código no sigue su guía de estilo, o si no contiene el pruebas apropiadas.

Una vez que haya identificado un repositorio al que le gustaría contribuir, eche un vistazo a la lista de problemas en el repositorio y decida qué le gustaría abordar. La lista de problemas se encuentra en la barra superior del repositorio.

Los proyectos bien mantenidos tendrán una variedad de etiquetas para tipos de problemas, prioridades e incluso niveles de experiencia o familiaridad necesarios para completarlos. Asegúrese de revisar los comentarios sobre un tema para obtener más información sobre el problema y sus posibles soluciones, así como para averiguar si alguien más ha logrado algún progreso al respecto.

Cuando trabaje en un archivo, puede usar el editor web de GitHub para realizar cambios. Desde el repositorio, haga clic en un archivo y luego haga clic en el icono de edición en la esquina superior derecha de ese archivo.

Esto abre el editor, donde puede realizar cambios en el contenido del archivo. Cuando termine, hay opciones en la parte inferior para elegir qué información de usuario agregar a las confirmaciones (si tiene más de una configurada) y si confirmar directamente con la rama maestra o con otra rama nueva o existente.

La Vista previa de cambios La pestaña en la parte superior le permite ver su Markdown renderizado de la misma manera que cualquier persona que vea el archivo en la web lo verá. En la parte superior derecha están los ajustes de las pestañas. Usted selecciona qué tipo de espaciado desea que usen las pestañas, cuántos espacios de ancho tienen y si desea tener un ajuste de palabra.

Cómo crear un repositorio en GitHub

Crear un repositorio es tan simple como ir a Repositorios y haciendo clic Nuevo en el tablero.

GitHub no requiere nombres de repositorio únicos en todo GitHub, ya que cada repositorio tiene un espacio de nombres (su nombre de usuario de GitHub), así que simplemente asígnele un nombre breve que se relacione directamente con el propósito del repositorio. Puede marcarlo como público o privado y continuar e inicializarlo con un archivo README.

Una vez hecho esto, verá que el repositorio tiene varias pestañas en la parte superior. En el Características sección de la configuración, puede habilitar o deshabilitar varias funciones de un repositorio:

Asuntos

Usted (u otros contribuyentes) crean problemas en su repositorio para rastrear todo tipo de trabajo: errores, tareas de desarrollo, historias de usuarios, etc. Para crear un problema, haga clic en Nuevo y escriba un título; las etiquetas sobre el tema indican si requiere un cierto nivel de experiencia o cuán urgente es.

Tablero de proyecto

El tablero de proyecto permite una gestión de estilo de «listas de tarjetas» de los problemas actualmente en foco, que opcionalmente admiten un flujo de trabajo de estilo Kanban. Para flujos de trabajo simples, esta placa puede actuar como un reemplazo para algo como Trello o las vistas de la placa en una herramienta de administración como Jira, con la ventaja adicional de estar vinculada directamente a los problemas.

Patrocinios

Esta es una característica más nueva que permite a las personas contribuir monetariamente al proyecto.

Wiki del proyecto

El wiki del proyecto de GitHub es un wiki minimalista y sencillo que te permite documentar tu proyecto. Si está habilitado, es un lugar excelente para una base de conocimientos o documentación básica, pero no sustituye a un sitio de documentación independiente o un portal de soporte para un proyecto más grande y complejo.

La Ajustes La pestaña también tiene otras secciones. Uno le dará opciones para administrar los contribuyentes a su repositorio, lo cual es especialmente importante si el repositorio es privado. La Webhooks La sección le permitirá configurar webhooks para enviar información sobre eventos del repositorio a servicios externos. También hay una pestaña para agregar direcciones de correo electrónico de notificación para eventos push al repositorio.

Los archivos dentro de un repositorio tienen el mismo tipo de estructura que tiene un proyecto de código en cualquier sistema de archivos. Puede crear directorios o archivos específicos, ya sea en el editor web o localmente en su computadora y sincronizados con el repositorio a través de Git. Crear un directorio en el editor web solo implica agregarlo antes del nombre al nombrar un archivo (por ejemplo, newdirectory/newfile.md).

Cómo administrar un repositorio en GitHub

Administrar un repositorio en GitHub implica muchas partes móviles: las solicitudes de extracción se utilizan para fusionar cambios en la base de código, los problemas lo ayudan a administrar las tareas en cuestión y los errores con su código actual, y puede realizar cambios tanto en el editor web como en en la zona.

Cómo administrar solicitudes de extracción en GitHub

Las solicitudes de extracción son la herramienta mediante la cual usted o sus compañeros colaboradores pueden trabajar en un repositorio. Con Git, los desarrolladores a menudo trabajan en funciones en ramas individuales aisladas. Después de completar el trabajo, el desarrollador que trabaja en la rama vuelve a fusionarlo con el maestro mediante una solicitud de extracción. Cuando un colaborador abre una solicitud de extracción, ahora tiene un lugar para comparar fácilmente la diferencia entre el maestro actual y los nuevos cambios. Los colaboradores y revisores conversan dentro de la solicitud de extracción sobre los cambios y resuelven los conflictos antes de fusionar los cambios de código.

La publicación de inicio en una solicitud de extracción tiene una descripción que, en la mayoría de los casos, detalla un resumen de lo que se cambió en la solicitud de extracción. La cadena de comentarios a continuación se leerá de manera similar a una conversación en un foro sobre este subconjunto de cambios.

La otra sección importante aquí es la Archivos cambiados en la parte superior de la solicitud de extracción. Aquí es donde se pueden ver los archivos modificados, mostrando líneas rojas de código eliminado o modificado y verde para las nuevas líneas. El revisor puede comparar fácilmente los dos y luego hacer comentarios basados ​​en los cambios.

Se pueden agregar etiquetas a una solicitud de extracción y también puede etiquetar personas como revisores si desea una revisión de un colaborador específico.

Cómo administrar los cambios locales en GitHub

Cuando trabaje en su repositorio, puede resultarle útil tener una copia en un entorno local, especialmente si a menudo realiza cambios y adiciones al repositorio. Lea nuestra guía de Cómo enviar a GitHub para obtener más información sobre ese proceso.

Cómo administrar lanzamientos en GitHub

Finalmente, también hay una sección en su repositorio llamada Lanzamientos, donde puede etiquetar estados particulares en su repositorio como versiones de lanzamiento. Esto permite que las personas que usan su software descarguen copias de la versión estable del proyecto, o que usted marque hitos particulares en su calendario de versiones. Cada lanzamiento se vincula con una confirmación en particular, por lo que el código base estará disponible para descargar en ese estado en cualquier momento desde el Lanzamientos pestaña.

GitHub ofrece opciones para que los usuarios que no son profesionales en Git y el control de versiones usen la interfaz web para actualizar el código y trabajar con solicitudes de extracción. Al mismo tiempo, proporciona a los desarrolladores experimentados una plataforma de alojamiento y colaboración que tomará información de cualquier línea de comando o programa de Git. Los desarrolladores con editores de código y entornos de desarrollo de todo tipo contribuyen, y todos se mantienen en la misma página.

Con sus repositorios privados gratuitos, ahora se encuentra en el mismo mercado competitivo que otras plataformas, tanto para equipos más grandes como para tiendas pequeñas. Los desarrolladores que buscan trabajo pueden usar su perfil de GitHub como currículum y, por supuesto, la industria del software de código abierto (OSS) prospera aquí, lo que permite a las personas encontrar y trabajar rápidamente en proyectos que contribuyen a la comunidad en general.