Reporte: Practica Creación, Gestión y Documentación de un Repositorio en
GitHub-Proyecto calculadora
Semestre: Tercero Grupo: “F”
Carrera: Programación
Equipo:
Jairo Vite Torres
Enrique Vite Estrada
Julio César Bautista Medina
Jesus Eduardo Nava Calderon
Keyla Naomi De La Cruz Ramos
Abel Iftahel De La Cruz
Vínculo al repositorio en GitHub:
[Link]
Introducción:
Esta práctica tiene como propósito aplicar y comprender los conceptos básicos de creación,
administración y manejo de un repositorio en github, el cual es una de las plataformas más
utilizadas para el trabajo colaborativo en proyectos de software.
Siendo esta una herramienta indispensable para el desarrollo moderno de software, que
permite el trabajo colaborativo, el control de versiones y documentación profesional,
organización del código, registro de cambios, y garantización que el proyecto cuente con un
historial ordenado de desarrollo que respalde cualquier error que puede llegar a suceder en
el desarrollo. Aunado a que git hub te da una mayor visibilidad y confianza a la hora de
buscar clientes ya que dentro de ella el mismo cliente puede ver tus trabajo de calidad.
Durante el desarrollo de la práctica se eligió como proyecto una calculadora, ya que es un
programa sencillo pero adecuado que nos permite practicar y aplicar tareas como
documentación, y aprender conceptos básicos de colaboración, gestión de códigos y
manejo de repositorios desde una plataforma que en nuestro caso fue Apache NetBeans.
Teniendo como objetivo desarrollar habilidades esenciales para gestionar proyectos
comprendiendo su importancia aplicándola en un proyecto funcional como lo es una
calculadora.
Desarrollo paso a paso
[Link]ón de cuentas de Github.
Cada uno de los integrantes del equipo creo una cuenta en github, buscando en su
navegador GitHub y entrando ala pagina oficial de github ([Link]
ingresando su correo electrónico personal, creando una contraseña, nombre de
usuario y seleccionando su país o región. Pidiéndonos realizar una verificación de
scherch y correo electrónico.
2. Creación de repositorio y README
Para crear un repositorio en github lo primero que hicimos fue ingresar al apartado de “
Crear repositorio “.
En el primer apartado general nombramos el nombre del repositorio, en este caso el nombre
fue “Calculadora Básica/Legión de exploración” , seguido de crear una breve descripción.
Posteriormente en el segundo apartado “Configuración” activamos repositorio público y
activamos add README. Y para terminar damos click al botón de crear repositorio.
3. Invitación a colaboradores
Para la invitación de colaboradores nos dirigimos al apartado “colaboradores”, donde
encontraremos administrar el acceso donde podemos buscar/invitar a los colaboradores ya
sea por su usuario. Para después de ello recibir un correo electrónico donde aceptaran la
invitación.
4. Clonación del repositorio en cada equipo
Para realizar esta clonación nos dirigiremos a code donde daremos click y copiaremos el
link que nos proporciones. En mi caso seria:
[Link]
Ahora nos dirigiremos a nuestro perfil y a la opción “Settings”, en la barra izquierda
buscaremos “Developer setting”, daremos click, seguiremos a token personal, damos click y
volvemos a dar click en token classic. Seguiremos en generar token classic, pondremos una
nota, cuando caducara y activamos todos los Select scopes y finalmente generar token. El
cual es importante copiar y guardar en algún documento porque es una clave única que
no volverá a aparecer.
Abrimos Netbeans y nos dirigiremos a la barra de menú donde seleccionaremos la opción
Team, posteriormente a “Remote” y daremos clic en “Clone”
Se nos abrirá la siguiente pestaña donde en “Repository URL” pondremos la URL antes
creada, pondremos nuestro nombre y el token que creamos. Seleccionaremos la carpeta
donde se guardará y damos seguir class master, siguiente y finalizar,
5. Desarrollo e implementación del código.
Durante el desarrollo e implementación del código todos los miembros participaron
desarrollando funciones y retroalimentación activa, que nos permitió obtener grandes
resultados.
6. Realización de commits, push y mensajes descriptivos
Commit para registrar cambios realizados en la calculadora.
Push para enviar los cambios del repositorio local al remoto
Mensajes descriptivos para documentar cambios del proyecto que esta por subirse a
la plataforma.
7. Ejecución y prueba del codigo de calculadora calculadora
La calculadora se ejecutó de manera precisa en el primer momento demostrando que
somos goodsss.
8. Proceso y aprobación de un pull request
Solicitud para funcionar cambios de una rama a otra, permitiendo revisión y
aprobación previa. Control de calidad mediante revisión ,Trabajo colaborativo
organizado,Historial de cambios documentado, Prevención de errores en código
principal ,Código integrado de forma controlada y [Link] en
documentación,Corrección de bugs, Correcciones urgentes,
9. Actualización del README y documentación
Creación de una nueva rama : Desarrollar la división sobre el manejo de errores , analizar
el código implementado , seguir con la verificación de seguimiento sobre el manejo de
errores , pruebas locales de la funcionalidad . Actualización del readme y documentación de
los avances y funcionalidades de la calculadora. Comentarios de revisión , historial del
comints , revisar los conflictos analizados, verificar las pruebas locales.
Actualización de nuevos funcionamientos dados a conocer en el README.
Resultados y reflexiones
1. Aportaciones individuales:
Jairo Vite Torres:Clonación del repositorio
Keyla Naomi De la Cruz Ramos:Clonación del repositorio, Desarrollo e
implementación del código,modificación y actualización del readme.
Enrique Vite Estrada:Creación del repositorio,Invitación a
colaboradores,modificación y actualización del readme.
Jesus Eduardo Nava Calderon:Clonación del repositorio,ejecución y prueba de la
calculadora,modificación y actualización del readme.
Julio Cesar Bautista Medina:Clonación del repositorio,modificación y actualización
del readme.
2. Problemas y soluciones
El único problema que tuvimos fue que al momento de poner nuestro usuario y
contraseña para mandar el código al repositorio esto no se validó y no podríamos
hacer este envío. Para ello realizamos una exhaustiva investigación donde nos
percatamos de que tenemos que hacerlo manual con ayuda de un token que nos
permite mandar el código.
3. Reflexión
Github sin duda alguna es una herramienta indispensable dentro del desarrollo de
cualquier proyecto ya que el trabajo colaborativo es clave para facilitar y organizar
nuestro trabajo. Si a eso le sumamos el soporte que brinda esta plataforma nos
damos cuenta que es indispensable más allá de servirnos por si tenemos errores,
guardar registros y documentación, nos permite desarrollarnos a nosotros mismos
en el ámbito profesional al ser considerado esta herramienta que permite mostrar
nuestro trabajo a clientes potenciales, respaldado por una fuerte comunidad que
puede ayudarte a resolver problemas y demás.
Enlace al repositorio y fuentes consultadas:
Repositorio:
[Link]
Fuentes consultadas:
[Link]
-repository