FAQ Github Profile Portfolio

Vista previa del material en texto

Q&A - Github Profile & Portfolio
¿Por qué es importante tener un Github completo y bien armado?
GitHub aloja más de 200 millones de repositorios, la mayoría de los cuales son proyectos de código abierto. Esta
estadística revela que GitHub se encuentra entre los clientes Git GUI más populares y es utilizado por varios
profesionales y grandes empresas. Tu Github es una especie de carta de presentación para identificar tus
verdaderos tech skills. Los reclutadores o líderes técnicos tendrán la oportunidad de revisar tu nivel de
participación en otros proyectos. Este es el lugar de mostrar lo que en realidad sabes hacer.
¿Qué contenido debe tener mi perfil en GitHub?
En tu perfil debes incluir información de quien eres, puntos de contacto, experiencia en tecnologías, redes
sociales profesionales que manejas y el valor agregado que aportas. Recuerda que tu perfil es la mejor
oportunidad para llamar la atención de la persona que está al otro lado de la pantalla.
¿Qué ven las empresas/recruiters?
Existen varios puntos que los tanto tech leads como recruiters revisan en tu Github.
1. Readme personal: Puedes incluir una breve descripción de tu perfil, experiencias y valor agregado
haciendo foco en tus habilidades técnicas. Puedes incorporar las tecnologías, enlaces a proyectos,
imágenes, etc.
2. Repositorios Populares: Definí estratégicamente tus mejores proyectos y posicionales dentro de tus pines.
3. Contribuciones: Aquí revisarán con que frecuencia aportas a proyectos propios como a proyectos de otras
personas.
4. Readme de proyectos: Asegurate que cada proyecto tenga un readme en donde expliques objetivo del
proyecto, qué tecnologías utilizamos e información general el cual ayude a generar una visión global del
proyecto.
¿Cómo habilito mi readme personal?
Debes crear un repositorio con tu nombre de usuario y en ese mismo repositorio agregas el readme y eso
es lo que github va a utilizar como tu readme personal.
¿Cómo se configura el readme?
Para comenzar a darle forma y contenido a nuestro profile, debemos utilizar el readme ubicado en el
repositorio creado con el username de github, ya sea desde el editor online o en nuestro IDE favorito.
A partir de MarkDown o HTML y unos cuantos íconos e imágenes ya estamos en condiciones de hacerlo brillar.
¿Cómo se cuentan las contribuciones?
Los cuadraditos verdes marcan tus contribuciones. Cuanto más intenso, más contribuciones. El objetivo es tener
esta grilla lo más cubierta posible!
https://www.hostinger.es/tutoriales/mejores-clientes-git-gui
https://stackshare.io/github
https://www.markdownguide.org/
Tus contribuciones, incluidas las confirmaciones de cambios, las solicitudes de extracción propuestas y las
propuestas abiertas(commits, pull requests & issues), se muestran en tu perfil para que las personas puedan ver
fácilmente el trabajo que has realizado. Tu gráfico de contribución de perfil es un registro de las contribuciones
que hiciste a los repositorios GitHub. Esto habla muchísimo de lo que aportamos cada día, y constituye una
prueba fehaciente de lo que hacemos y cómo.
Recomendamos siempre seguir buenas prácticas de programación.
¿Cómo hago para visualizar las contribuciones privadas?
Para activar la visibilidad de tus contribuciones a repositorios privados, debés dirigirte al panel de contribuciones
de tu perfil, justo debajo de los Pinned repositories, hacer click en contribution settings y habilitar Private
contributions y Activity overview.
¿Por qué es importante mantener actualizado mi perfil?
Una cuenta que está siendo constantemente actualizada demuestra compromiso y dedicación. Es mejor hacer
pequeños cambios e ir commiteándolos en cortos períodos de tiempo que esperar a terminar toda la jornada para
registrar nuestra versión. ¿Dónde se puede medir esto último? En las contribuciones. Lógicamente en los inicios
es comprensible que no tengas una actividad muy alta, pero con el pasar del tiempo éstas deben ser frecuentes.
¿Qué debo incluir en el readme de cada proyecto?
Pregúntate a vos mismo/a: Una persona que no conoce de tecnología, leyendo mi Readme, ¿Logra entender de
qué se trata la aplicación? ¿La puede levantar y probar?
Procura que el nombre del repositorio sea descriptivo, que a través del mismo se pueda suponer de que se trata.
La documentación de tu código es muy útil, no solo para los usuarios que intentan usar las herramientas, sino
también para quienes miran tu perfil.
En tu documentación debes incluir el propósito y los casos de uso de tu proyecto. También debe incluir
instrucciones de instalación para que los usuarios puedan ejecutar o utilizar fácilmente cualquier herramienta o
producto que hayas creado. Por último puedes incluir una demostración (capturas de pantalla o imágenes) y/o un
enlace de demostración para que se pueda ver tu trabajo fácilmente.
¿Qué más puedo hacer para tener un readme atractivo?
Puedes incluir emojis, imágenes y etiquetas. Esto hará que tu readme sea más atractivo. Para esto puedes
apoyarte de diferentes paginas donde pueden bajar etiquetas de color para agregar a sus readme y múltiples
ejemplos.
¿Qué son los pines en los repositorios?
Destacar tus repositorios por medio de pins es una estrategia para mostrarle a la persona que está visitando tu
página los trabajos que consideras más relevantes. Se sugiere tener entre 3 a 4 repositorios destacados, debes
elegir con cuidado pensando siempre en que quieres mostrar. A medida que vayas incluyendo más proyectos
deberás actualizar tus destacados. Recuerda que no se pueden destacar más de 6 pines.
¿Cómo se configuran los repositorios populares?
En tu perfil, inmediatamente debajo del profile readme.md aparecerá un botón con el texto Customize your pins.
Allí aparecerán listados nuestros repositorios públicos entre los cuales podremos elegir como máximo hasta 6 de
ellos.
¿Cómo puedo mostrar que trabajé en equipo?
https://gist.github.com/henry-labs/fde7766161fb098a8e4edc04cc4caa97
https://rahuldkjain.github.io/gh-profile-readme-generator/
https://shields.io/
https://github.com/kautukkundan/Awesome-Profile-README-templates
https://github.com/kautukkundan/Awesome-Profile-README-templates
Hay muchas formas de demostrar que un proyecto fue realizado colaborativamente. Una buena forma de
visualizarlo inmediatamente es construyendo una sección de About Us en los mismos y adjuntando capturas y
enlaces a los respectivos perfiles de github en los README. Siempre es recomendable citar las metodologías
utilizadas por el equipo de desarrollo.
¿Debería publicar los challenges que realicé en mis procesos de entrevistas con
empresas?
Si! Muchos procesos de selección involucran la realización de un proyecto en un plazo de días o semanas. Estos
proyectos son de tu autoría y no vas a tener problema al mostrarlo en tu Github. Al publicar los challenges que
realizaste vas a poder mostrar que es lo que sabes hacer y te dará más visibilidad.
Algunos ejemplos de perfiles de Github
WanCirone | Em3c2 | tomas0011 | JavierBalonga | cescontreras | ElefanteNegro
¿Cómo puedo crear mi Github Page?
Crear tu Github page es muy fácil, solo debes ir a la configuración de tu repositorio y en la pestaña Pages
indicarle a Github en qué directorio se encuentra tu código html.
Para servir una React-App configurarla lleva 5 minutos. Tutorial por aquí
¿Qué tipo de aplicaciones y tecnologías puedo utilizar con Github Pages?
Puedes utilizar distintas aplicaciones y tecnologías como lo son: HTML, CSS y Javascript, ideal para servir webs
estáticas y sin costo alguno. Las prestaciones son amplias y suficientes para un portfolio e incluso un blog.
¿Se puede configurar en Github Pages un proyecto de back end o front end
indistintamente?
En caso de que queramos instanciar Node, debemos recurrir a otros servicios como Heroku. GitHub pages sólo
nos servirá para lucir nuestros front end skills.
¿Se pueden conectar bases de datos a una aplicación en Github Pages?
No se puede conectar a una base de datos desde una web estática, aunque bien puedes implementar una fake
API que devuelvejson hardcodeado.
¿Puedo usar una plantilla prearmada para Portfolio?
Puedes apoyarte de plantillas si el diseño no es tu fuerte. Aquí encontrarás múltiples plantillas en github desde las
cuales puedes comenzar a armar tu portafolio. Te recomendamos ver varios ejemplos antes de incursionar en la
inspiración. Algunos ejemplos de portfolios que te pueden ayudar son :
Julignacio | agustin-d-jaime | acevedonm | serene-lovelace | ignacio-gimenez | Eme-resume
https://github.com/WanCirone
https://github.com/Em3c2
https://github.com/tomas0011
https://github.com/JavierBalonga
https://github.com/cescontreras
https://github.com/ElefanteNegro
https://betterprogramming.pub/how-to-host-your-react-app-on-github-pages-for-free-919ad201a4cb
https://github.com/topics/portfolio-template
https://julignacio.vercel.app/
https://agustin-d-jaime.netlify.app/
https://acevedonm.github.io/portafolio/
https://serene-lovelace-017391.netlify.app/
https://ignacio-gimenez.vercel.app/
https://eme-resume.vercel.app/en_US