Capítulo 11: GitHub como portafolio profesional¶

GitHub es mucho más que un lugar para alojar código: se ha convertido en una carta de presentación técnica para desarrolladores, estudiantes y profesionales. Muchas empresas revisan perfiles de GitHub para entender qué proyectos has construido, cómo documentas tu trabajo y cómo colaboras con otras personas.

En este capítulo vas a transformar tu cuenta y el proyecto del libro en un portafolio profesional: configurarás tu perfil, crearás un README de perfil atractivo, documentarás correctamente el sitio web personal, organizarás tus repositorios y elegirás licencias adecuadas para poder compartir tu trabajo con empleadores, clientes o colaboradores.

11.1 GitHub como carta de presentación¶

Tu perfil de GitHub y tus repositorios cuentan una historia sobre ti: qué te interesa, qué sabes hacer y cómo trabajas. La documentación oficial describe el perfil como un lugar para compartir intereses, mostrar proyectos y expresar tu identidad ante la comunidad.¹

Por qué muchas empresas revisan perfiles de GitHub¶

En entrevistas técnicas y procesos de selección, es frecuente que:

se pida el enlace a tu perfil de GitHub;
se revisen repositorios destacados;
se lean README y mensajes de commit.

Esto permite ver ejemplos reales de tu trabajo más allá del currículum: código, documentación, historial de cambios y participación en proyectos.

Qué transmite un repositorio bien organizado¶

Un repositorio cuidado comunica:

claridad: README que explica qué hace el proyecto y cómo usarlo;
orden: estructura de carpetas coherente;
profesionalismo: licencia, guía de contribución, código de conducta;
responsabilidad: commits claros y documentación actualizada.

Por el contrario, repositorios sin README, sin descripción o con nombres confusos transmiten desorden y dificultan que otros entiendan tu trabajo.

Subir código vs construir presencia profesional¶

Subir código es solo el primer paso. Construir una presencia profesional implica:

elegir qué proyectos mostrar;
documentarlos correctamente;
organizar tu perfil para que los mejores trabajos estén visibles;
conectar GitHub con otras piezas de tu marca profesional.

flowchart TD
    A[Código sin contexto] --> B[Repositorio básico]
    B --> C[Repositorio documentado]
    C --> D[Portafolio profesional en GitHub]

[Ilustración: vista conceptual de dos perfiles de GitHub lado a lado, uno casi vacío con repositorios sin descripción y otro con README cuidados, repositorios fijados y perfil completo]

Nota

Tu perfil de GitHub suele ser la primera impresión técnica que alguien tiene de ti. Un buen portafolio puede marcar la diferencia frente a otros candidatos con experiencia similar.

Breve conclusión: GitHub funciona como una carta de presentación técnica: repositorios organizados, documentación y perfil completo crean una imagen profesional que muchas empresas revisan antes de decidir.

11.2 Configurando el perfil¶

La página de perfil de GitHub incluye foto, nombre, biografía, ubicación y enlaces. La guía oficial muestra cómo personalizar estos elementos para que otros vean quién eres y qué te interesa.

Fotografía y nombre¶

Fotografía: elige una imagen clara y profesional. No tiene que ser formal, pero sí coherente con la imagen que quieres dar.
GitHub permite subirla desde Settings > Profile Picture.
Nombre: usa tu nombre real o la forma en que quieres ser conocido profesionalmente. Esto ayuda a que reclutadores y clientes conecten tu perfil con tu currículum y LinkedIn.

Biografía, ubicación y enlaces¶

Biografía: escribe una o dos frases que resuman quién eres y qué haces (por ejemplo, "Desarrollador Frontend apasionado por la educación y el diseño de interfaces").
Ubicación: indica tu ciudad o región si te interesa recibir oportunidades localizadas.
Enlaces: añade tu sitio web, blog técnico y otras redes profesionales (especialmente LinkedIn).

Conviene evitar:

información demasiado personal (direcciones exactas, teléfonos sin necesidad);
detalles que no aporten a tu perfil profesional.

Redes profesionales y sitio web¶

GitHub permite enlazar:

tu portafolio web (por ejemplo, el sitio del libro publicado con GitHub Pages);
tu perfil de LinkedIn;
otros recursos relevantes (blog técnico, cuenta de X enfocada en contenido profesional).

Estos enlaces conectan tu ecosistema profesional: quien llegue a tu perfil puede descubrir más sobre ti en otros formatos.

Consejo

Revisa tu perfil de GitHub desde la perspectiva de un reclutador: ¿entiende rápidamente quién eres, qué haces y dónde encontrar más información sobre ti?

Breve conclusión: configurar foto, nombre, bio y enlaces transforma tu perfil de GitHub en un punto de entrada profesional claro, alineado con tu currículum y otras redes.

11.3 README del perfil¶

GitHub permite crear un README especial que se muestra directamente en tu página de perfil. La documentación explica que esto se logra creando un repositorio público con el mismo nombre que tu usuario y un archivo README.md en la raíz.²

Cómo crear el README de perfil¶

Según GitHub Docs:

Crea un repositorio público cuyo nombre coincida con tu usuario (por ejemplo, si tu usuario es octocat, el repositorio debe llamarse octocat).
Activa la opción Add README al crearlo.
Edita el archivo README.md en la raíz.

GitHub mostrará ese README en tu perfil siempre que:

el repositorio sea público;
el nombre coincida con tu usuario;
README.md tenga contenido.

Elementos recomendados del README de perfil¶

Un README de perfil profesional puede incluir:

Presentación: quién eres, qué te apasiona.
Tecnologías: lenguajes, frameworks, herramientas principales.
Proyectos destacados: enlaces a repositorios clave (incluyendo el proyecto del libro).
Enlaces: portafolio web, LinkedIn, otras redes.
Estadísticas: opcionalmente, tarjetas que muestran actividad (repos, contribuciones) mediante servicios externos.
Insignias (Badges): indicadores de tecnologías o servicios (por ejemplo, Shields.io).
Contacto: cómo pueden escribirte (correo profesional, formulario en tu sitio).

Elemento	Propósito
Presentación	Contextualiza quién eres y qué haces
Tecnologías	Muestra tu stack principal
Proyectos	Dirige la atención a tus mejores trabajos
Enlaces	Conecta GitHub con tu ecosistema profesional
Estadísticas y badges	Añaden capa visual y resumen rápido
Contacto	Facilita que te contacten colaboradores o empleadores

Ejemplo aplicado al proyecto del libro¶

En tu README de perfil, podrías incluir una sección como:

"Proyecto destacado: Sitio web personal desarrollado en el curso 'Git y GitHub Profesional'";
enlace al repositorio;
enlace al sitio publicado en GitHub Pages.

[Ilustración: ejemplo de README de perfil de GitHub con secciones "Sobre mí", "Tecnologías", "Proyectos", "Contacto" y tarjetas visuales de estadísticas, aplicado a un desarrollador que muestra el proyecto del libro como trabajo destacado]

Buenas prácticas

Mantén el README de perfil actualizado: si cambias de stack, creas proyectos nuevos o publicas más contenido, actualiza esta carta de presentación.

Breve conclusión: el README de perfil convierte tu página de GitHub en un portafolio construido con Markdown, donde puedes presentar tu historia, tecnologías y proyectos clave de forma atractiva.

11.4 Documentando un proyecto¶

La documentación de GitHub recuerda que el README de un repositorio suele ser lo primero que ve cualquier visitante. Un buen README explica qué hace el proyecto, por qué es útil y cómo se utiliza.

Estructura recomendada de un README profesional¶

Según GitHub Docs, un README suele incluir:³

Descripción: qué hace el proyecto y por qué existe.
Características: principales funcionalidades.
Instalación: cómo clonar y preparar el entorno.
Uso: cómo ejecutar y navegar el proyecto.
Capturas: imágenes que muestren la interfaz o resultados.
Tecnologías: lenguajes, frameworks y herramientas utilizadas.
Estructura del proyecto: resumen de carpetas y archivos clave.
Licencia: qué pueden hacer otros con el código.
Autor: quién mantiene el proyecto.

Aplicado al proyecto del libro¶

Para el sitio web personal, tu README podría organizarse así:

Descripción: "Sitio web personal desarrollado como proyecto principal del libro 'Git y GitHub Profesional', incluye páginas de inicio, contacto y recursos.";
Características: navegación simple, estilos personalizados, estructura preparada para GitHub Pages;
Instalación: pasos de git clone y abrir index.html en el navegador;
Uso: explicación de secciones y navegación;
Capturas: imágenes del sitio publicado;
Tecnologías: HTML, CSS, JavaScript;
Estructura: breve árbol de carpetas (css/, images/, etc.);
Licencia: referencia a archivo LICENSE;
Autor: tu nombre y enlaces.

Por qué una buena documentación genera confianza¶

demuestra que te preocupa la experiencia de otras personas al usar tu código;
facilita que reclutadores y colaboradores entiendan el proyecto sin leer todo el código;
muestra tu capacidad de comunicar de forma clara, una habilidad clave en trabajos técnicos.

Error común

Dejar README vacíos o con información mínima. Un repositorio sin documentación obliga al visitante a adivinar qué hace el proyecto y cómo usarlo, lo que reduce su impacto profesional.

Breve conclusión: un README bien estructurado transforma el proyecto del libro en un recurso comprensible y reutilizable, incrementando la confianza de quienes lo revisan como parte de tu portafolio.

11.5 Organización de repositorios¶

Además del contenido de cada repositorio, la forma en que organizas y presentas tus proyectos en GitHub influye en cómo otros perciben tu trabajo.

Nombres adecuados y descripciones¶

usa nombres claros y descriptivos (por ejemplo, sitio-web-personal, api-rest-ejemplo, curso-git-github);
añade una descripción breve en cada repositorio, indicando propósito y tecnología principal.

Evita nombres como prueba1, nuevo-proyecto o cosas-varias, que no explican nada.

Topics y etiquetas¶

GitHub permite añadir Topics (etiquetas) a cada repositorio para indicar tecnologías, categorías o ámbitos:

html, css, javascript para el sitio del libro;
portfolio, education, personal-website como categorías.

Estos Topics ayudan a que otros encuentren proyectos relacionados y entiendan de un vistazo de qué trata el repositorio.

Fijar repositorios destacados¶

Puedes fijar varios repositorios en tu perfil para que aparezcan siempre en la sección superior. Conviene destacar:

el proyecto del libro (sitio web personal);
otros proyectos con buena documentación y relevancia profesional;
repositorios que muestren variedad de habilidades.

Repositorios públicos y privados¶

Públicos: para proyectos que quieras mostrar en tu portafolio.
Privados: para experimentos, trabajo en progreso o contenido que no deseas compartir.

Equilibra ambos tipos para mantener tu perfil ordenado y evitar mostrar proyectos sin terminar.

Elemento	Recomendación
Nombre del repositorio	Claro, descriptivo y en un idioma coherente
Descripción	Breve resumen de propósito y tecnología
Topics	Tecnologías y categorías relevantes
Repositorios fijados	Proyectos mejor documentados y representativos
Público vs privado	Mostrar solo lo que aporta a tu portafolio

[Ilustración: vista de un perfil de GitHub con repositorios fijados, nombres descriptivos, descripciones claras y Topics visibles bajo cada repositorio]

Buenas prácticas

Revisa periódicamente tu lista de repositorios: archiva o privatiza proyectos obsoletos y destaca aquellos que mejor representen tus habilidades actuales.

Breve conclusión: nombres claros, descripciones, Topics y repositorios fijados convierten tu cuenta de GitHub en un catálogo organizado de tu trabajo, fácil de explorar por cualquier visitante.

11.6 Licencias¶

Elegir una licencia adecuada es parte de profesionalizar tus proyectos. Licencias como MIT, Apache 2.0, GPL y BSD definen qué pueden hacer otros con tu código y bajo qué condiciones.

MIT¶

La licencia MIT es una de las más utilizadas. Es:

muy permisiva;
permite usar, copiar, modificar y distribuir el código, incluso comercialmente;
exige mantener el aviso de copyright y la nota de licencia.

Es ideal para:

proyectos personales;
librerías y plantillas que quieres compartir libremente;
código educativo, como el proyecto del libro.

Apache 2.0¶

La licencia Apache 2.0 también es permisiva, similar a MIT pero con una cláusula de protección de patentes.

permite uso, modificación y distribución;
incluye disposiciones sobre patentes que protegen tanto a autores como a usuarios;
suele ser preferida por empresas que cuidan aspectos legales de propiedad intelectual.

GPL¶

La GPL (General Public License) es una licencia de copyleft fuerte:

permite usar y modificar el código;
exige que cualquier proyecto derivado también sea distribuido bajo GPL;
busca proteger que el software permanezca libre y abierto.

Es adecuada para:

proyectos comunitarios donde se quiere garantizar apertura futura;
herramientas que no deben integrarse en software privativo sin liberar cambios.

BSD¶

Las licencias BSD (2-cláusula, 3-cláusula) son muy permisivas y minimalistas:

permiten casi cualquier uso, con pocas restricciones;
típicamente exigen mantener avisos de copyright;
son apreciadas por su simplicidad.

Cuándo utilizar cada una¶

Licencia	Características clave	Cuándo usarla
MIT	Permisiva, simple, requiere conservar aviso de copyright.	Proyectos personales, código educativo, librerías pequeñas
Apache 2.0	Permisiva con protección de patentes.	Proyectos usados por empresas o que implican patentes
GPL	Copyleft fuerte, obliga a liberar proyectos derivados.	Software comunitario que debe seguir siendo libre
BSD	Muy permisiva, restricciones mínimas.	Proyectos donde se busca máxima flexibilidad y simplicidad

Para la mayoría de proyectos personales, especialmente el sitio web del libro, la licencia MIT suele ser suficiente: permite que otros aprendan y reutilicen tu código manteniendo un reconocimiento claro.

Nota

Elegir una licencia es una decisión estratégica. Aunque MIT es una gran opción por defecto en proyectos personales educativos, revisa siempre sus implicaciones si tus proyectos crecen o se vuelven comerciales.

Breve conclusión: licencias como MIT, Apache 2.0, GPL y BSD ofrecen distintos niveles de permisividad y protección. Para la mayoría de proyectos personales y educativos, MIT es una opción simple y adecuada.

11.7 Buenas prácticas profesionales¶

Además de configuración y licencias, tu comportamiento técnico en GitHub también construye tu imagen profesional.

Frecuencia de actualización y calidad de commits¶

mantener actividad regular (sin obsesionarse) muestra que sigues practicando y aprendiendo;
mensajes de commit claros facilitan entender la historia del proyecto;
commits pequeños y enfocados reflejan buen manejo de Git.

Mantener proyectos terminados y evitar repositorios abandonados¶

procura que tus proyectos destacados estén completos o claramente etiquetados como "en desarrollo";
evita dejar repositorios públicos con código incompleto o sin explicación;
si un proyecto ya no representa tu nivel actual, puedes archivarlo o marcarlo como legado.

Documentar correctamente¶

actualiza README cuando cambies funcionalidades importantes;
añade secciones de "Estado del proyecto" (por ejemplo, "Activo", "Mantenimiento mínimo", "Archivado");
documenta decisiones relevantes (especialmente en proyectos colaborativos).

Recomendaciones para entrevistas laborales y proyectos freelance¶

prepara un pequeño listado de repositorios clave para compartir en entrevistas (incluyendo el proyecto del libro bien documentado);
en freelance, usa GitHub para mostrar entregables, documentación y comunicación técnica;
en ambos casos, orienta el entrevistador hacia repositorios que muestren tanto código como documentación.

Buenas prácticas

Trata tus repositorios públicos como vitrinas: aunque tengas proyectos internos o privados, lo que muestras en GitHub debería reflejar tu mejor versión técnica y comunicativa.

Breve conclusión: actualizar, documentar y seleccionar cuidadosamente los proyectos visibles en GitHub refuerza tu imagen profesional y facilita que empleadores y clientes entiendan tu valor técnico.

11.8 Construyendo una marca profesional¶

GitHub no está aislado: forma parte de un ecosistema de herramientas que, juntas, construyen tu marca personal como desarrollador.

Integración con LinkedIn, portafolio web y currículum¶

en LinkedIn, puedes enlazar repositorios y el sitio publicado con GitHub Pages;
en tu portafolio web (incluyendo el proyecto del libro), puedes enlazar repositorios de código y explicar cómo se desarrollaron;
en el currículum, incluye tu usuario de GitHub y enlaces a proyectos clave.

Relación con blog técnico y proyectos publicados¶

si escribes artículos técnicos, enlaza repositorios relacionados;
utiliza GitHub para alojar ejemplos de código complementarios a tus posts;
muestra proyectos reales publicados (como el sitio del libro) para conectar teoría y práctica.

flowchart TD
    A[GitHub] --> B[LinkedIn]
    B --> C[Portafolio web]
    C --> D[Currículum]
    D --> E[Proyectos publicados]
    A --> C
    A --> E

Este diagrama ilustra cómo GitHub alimenta y se alimenta de otras piezas de tu marca profesional: todos los elementos se refuerzan mutuamente.

[Ilustración: ecosistema donde se ven iconos de GitHub, LinkedIn, un sitio web y un documento de currículum conectados entre sí, con flechas que muestran cómo los proyectos de GitHub se enlazan en cada elemento]

¿Sabías que...?

Muchos reclutadores técnicos usan GitHub como punto de validación: comparan lo que dices en tu CV y LinkedIn con los proyectos y actividad que ven en tu cuenta.

Breve conclusión: convertir GitHub en parte de tu marca profesional implica conectarlo con LinkedIn, portafolio, currículum y proyectos publicados, creando una narrativa coherente sobre quién eres y qué sabes hacer.

Práctica guiada¶

En esta práctica vas a aplicar todo lo aprendido al proyecto del libro y a tu perfil de GitHub.

Paso 1: completar tu perfil de GitHub¶

Añade una foto de perfil profesional desde Settings > Profile Picture.
Escribe una bio breve que resuma tu rol y enfoque.
Añade ubicación y enlaces a tu portafolio (incluyendo el sitio del libro) y LinkedIn.

Paso 2: crear un README profesional para el perfil¶

Crea un repositorio público con el mismo nombre que tu usuario.
Añade un README.md inicial.
Estructura el README con secciones de presentación, tecnologías, proyectos, enlaces y contacto.
Incluye el proyecto del libro como uno de tus proyectos destacados.

Paso 3: mejorar el README del proyecto del libro¶

Revise el README actual del repositorio del sitio.
Añade o mejora secciones de descripción, características, instalación y uso.
Incluye capturas del sitio publicado mediante GitHub Pages.
Añade información de tecnologías y estructura del proyecto.
Revisa la sección de licencia y autor.

Paso 4: agregar capturas del proyecto¶

Toma capturas de pantalla del sitio publicado.
Añádelas al repositorio (por ejemplo, en una carpeta images/).
Incluye las capturas en el README usando Markdown.

Paso 5: organizar repositorios y configurar Topics¶

Revisa tu lista de repositorios.
Renombra repositorios con nombres más claros si es necesario.
Añade descripciones y Topics relevantes al proyecto del libro y otros proyectos clave.
Fija en tu perfil los repositorios más representativos.

Paso 6: elegir una licencia¶

Decide qué licencia aplicar al proyecto del libro (MIT suele ser una buena opción).
Añade el archivo LICENSE correspondiente al repositorio.
Menciona la licencia en el README.

Paso 7: compartir el perfil utilizando un enlace público¶

Copia la URL de tu perfil de GitHub.
Añádela a tu currículum y perfil de LinkedIn.
Compártela con compañeros, docentes o potenciales empleadores.

flowchart TD
    A[Completar perfil] --> B[Crear README de perfil]
    B --> C[Documentar proyecto del libro]
    C --> D[Organizar repositorios y Topics]
    D --> E[Elegir licencia]
    E --> F[Compartir perfil profesional]

[Ilustración: secuencia visual mostrando un perfil de GitHub antes y después de la práctica: el "antes" con perfil incompleto y repositorios sin README, y el "después" con perfil completo, README de perfil, repositorios fijados y documentación clara]

Consejo

Una vez completes esta práctica, pide feedback a docentes, colegas o mentores sobre tu perfil. Ajusta texto, proyectos y organización con base en sus comentarios.

Breve conclusión: la práctica guiada convierte tu cuenta de GitHub y el proyecto del libro en un portafolio profesional listo para compartirse, con perfil completo, README cuidados, repositorios organizados y licencias claras.

Cierre del capítulo¶

En este capítulo convertiste GitHub en tu carta de presentación profesional: configuraste un perfil completo, creaste un README de perfil sólido, documentaste el proyecto del libro con un README profesional, organizaste repositorios y elegiste licencias adecuadas.

También aprendiste buenas prácticas para mantener tus proyectos y actividad en GitHub alineados con tu imagen profesional, y viste cómo integrar tu cuenta con otras piezas de tu marca personal (LinkedIn, portafolio, currículum). A partir de ahora, tu perfil de GitHub no es solo un lugar con código: es un portafolio preparado para ser compartido con empleadores, clientes y colaboradores.

Notas al pie¶

Setting up your profile - GitHub Docs. https://docs.github.com/en/get-started/start-your-journey/setting-up-your-profile ↩
Managing your profile README - GitHub Docs. https://docs.github.com/en/account-and-profile/how-tos/profile-customization/managing-your-profile-readme ↩
About the repository README file - GitHub Docs. https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readme-files ↩