image

Unlimited bootcamps and 750+ courses forever

70
%OFF
Article image
Marcus Guedes
Marcus Guedes17/08/2026 16:35
Share
IBM Bob: IA de Nível Empresarial para Desenvolvedores e Tech LeadersRecommended for youIBM Bob: IA de Nível Empresarial para Desenvolvedores e Tech Leaders

Seu GitHub conta uma história ou apenas armazena códigos ?

    Durante muito tempo, eu enxerguei o GitHub principalmente como um lugar para armazenar projetos.

    Um curso terminava, um desafio era concluído, um código funcionava e mais um repositório era criado.

    Tecnicamente, fazia sentido.

    Profissionalmente, comecei a perceber que faltava alguma coisa.

    Quando decidi aprofundar minha trajetória em Data Science e Inteligência Artificial, passei também a olhar para o meu portfólio de outra forma.

    A pergunta deixou de ser apenas:

    “Quantos projetos eu tenho no GitHub?”

    E passou a ser:

    “O que esses projetos dizem sobre mim?”

    Essa mudança de perspectiva parece pequena, mas alterou bastante a forma como passei a construir e organizar meu portfólio.

    Um repositório não é necessariamente um projeto

    Quem estuda tecnologia acumula código.

    Cursos, bootcamps, desafios, notebooks, testes de APIs, exercícios de Machine Learning, pequenos experimentos...

    Tudo isso faz parte do processo de aprendizagem.

    Mas existe uma diferença importante entre armazenar código e construir um portfólio.

    Um repositório pode demonstrar que determinado código foi escrito.

    Um bom projeto precisa conseguir explicar algo maior:

    qual problema existia, por que determinada abordagem foi escolhida, quais tecnologias foram utilizadas, quais dificuldades surgiram, quais resultados foram alcançados e o que foi aprendido durante o processo.

    Foi quando comecei a perceber que o README não deveria ser apenas uma formalidade.

    Ele faz parte do projeto.

    Código mostra execução. Contexto mostra raciocínio.

    Imagine alguém chegando ao seu GitHub pela primeira vez.

    Essa pessoa provavelmente não vai abrir dezenas de arquivos .py, notebooks ou componentes para tentar descobrir o que você sabe fazer.

    Ela precisa entender rapidamente:

    O que é esse projeto?

    Que problema ele resolve?

    Qual foi a sua contribuição?

    Quais tecnologias foram utilizadas?

    O que existe de interessante tecnicamente aqui?

    Existe uma aplicação funcionando?

    Esse exercício me fez perceber que documentação também é comunicação.

    E comunicação é uma competência profissional.

    Um projeto bem apresentado consegue mostrar não apenas conhecimento técnico, mas também organização, capacidade analítica, visão de produto e entendimento de negócio.

    Foi aí que comecei a olhar para o conjunto

    Ao revisar meu próprio GitHub, percebi que existiam projetos de diferentes momentos da minha jornada.

    Alguns relacionados a análise de dados e Machine Learning.

    Outros envolvendo Marketing Intelligence.

    Projetos com RAG e Inteligência Artificial Generativa.

    Experimentos envolvendo grafos e sistemas de recomendação.

    Aplicações com APIs, automações, dashboards e interfaces web.

    Individualmente, cada projeto mostrava uma tecnologia ou aprendizado.

    Mas juntos eles poderiam mostrar algo mais importante:

    evolução.

    Foi então que comecei a pensar no GitHub não como uma coleção de repositórios, mas como uma narrativa profissional.

    Nem todo projeto precisa ter a mesma complexidade

    Outro aprendizado importante foi entender que portfólio não significa construir dez sistemas gigantescos.

    Um projeto relativamente simples pode ser extremamente relevante se demonstrar claramente uma competência.

    Uma análise exploratória pode mostrar capacidade de investigação.

    Um dashboard pode demonstrar transformação de dados em informação.

    Um modelo preditivo pode mostrar conhecimento de Machine Learning.

    Uma API pode demonstrar preocupação com integração.

    Um projeto com RAG pode evidenciar conhecimento de aplicações modernas de IA Generativa.

    Um sistema de recomendação pode mostrar como diferentes técnicas podem ser combinadas para resolver um problema.

    A questão não é apenas a complexidade.

    É o que aquele projeto prova que você sabe fazer.

    Projetos também precisam de curadoria

    Esse talvez tenha sido um dos pontos mais importantes para mim.

    Quando estamos aprendendo, existe uma tendência natural de querer mostrar tudo.

    Cada curso.

    Cada exercício.

    Cada pequeno projeto.

    Mas um portfólio profissional precisa de curadoria.

    Se alguém tiver apenas alguns minutos para olhar seu perfil, quais projetos você gostaria que essa pessoa visse primeiro?

    Essa pergunta muda completamente a lógica.

    Os projetos destacados deixam de ser necessariamente os mais recentes e passam a ser aqueles que melhor representam as competências que você quer comunicar.

    É quase como montar uma vitrine.

    A loja pode ter centenas de produtos no estoque.

    Mas a vitrine precisa contar uma história.

    O README passou a fazer parte dessa estratégia

    Passei então a valorizar muito mais alguns elementos:

    • uma descrição clara do problema;
    • objetivos do projeto;
    • tecnologias utilizadas;
    • arquitetura ou fluxo da solução;
    • principais funcionalidades;
    • resultados obtidos;
    • instruções para execução;
    • imagens ou demonstrações quando fazem sentido;
    • link para aplicação publicada;
    • aprendizados e possíveis evoluções.

    Isso não transforma automaticamente um projeto simples em algo extraordinário.

    Mas permite que quem está olhando consiga entender o trabalho sem precisar investigar todo o código.

    E isso faz diferença.

    Deploy muda a percepção de um projeto

    Existe também uma diferença interessante entre dizer:

    “Eu desenvolvi uma aplicação.”

    e poder dizer:

    “Ela está funcionando aqui.”

    Quando comecei a publicar alguns projetos utilizando ferramentas como Streamlit, Vercel e GitHub Pages, percebi como isso mudava a experiência de apresentar o portfólio.

    O projeto deixa de ser apenas código.

    Ele pode ser acessado, testado e experimentado.

    Naturalmente, nem todo projeto precisa estar em produção.

    Mas quando existe uma interface, um dashboard, um agente ou uma aplicação interativa, disponibilizar uma demonstração aproxima muito mais o projeto de um produto funcional.

    O portfólio começou a refletir minha própria trajetória

    Talvez essa seja a parte que considero mais interessante.

    Minha carreira não começou em tecnologia.

    Minha experiência foi construída em áreas como Marketing, Operações, Gestão Comercial e Gestão de Projetos.

    Quando Dados e IA passaram a ocupar um espaço cada vez maior na minha formação, eu não queria simplesmente apagar essa trajetória anterior.

    Queria conectá-la.

    Por isso, hoje me interessam especialmente projetos em que tecnologia não aparece isoladamente.

    Prefiro pensar em perguntas como:

    Que decisão essa análise pode melhorar?

    Que processo essa automação pode simplificar?

    Que informação esse modelo consegue transformar em ação?

    Como IA pode ser incorporada a um problema real de negócio?

    Esse raciocínio também começou a aparecer no meu GitHub.

    E talvez seja exatamente isso que eu queira que meu portfólio comunique.

    Não apenas que estou aprendendo novas tecnologias.

    Mas como estou conectando essas tecnologias à experiência profissional que construí ao longo da minha carreira.

    GitHub como evidência, não como currículo

    Hoje vejo LinkedIn, currículo e GitHub cumprindo funções diferentes.

    O currículo resume uma trajetória.

    O LinkedIn ajuda a contextualizá-la e construir presença profissional.

    O GitHub pode apresentar evidências concretas.

    Código.

    Análises.

    Modelos.

    Dashboards.

    Documentação.

    Arquiteturas.

    Aplicações funcionando.

    Problemas resolvidos.

    E, principalmente, evolução.

    Por isso, talvez a pergunta mais interessante não seja:

    “Você tem GitHub?”

    Mas:

    “Se alguém entrar hoje no seu GitHub, conseguirá entender para onde sua carreira está indo?”

    Tenho feito essa pergunta constantemente ao revisar meu próprio portfólio.

    Porque acumular códigos é relativamente fácil.

    Transformá-los em uma história coerente de aprendizado, competências e evolução profissional é um projeto completamente diferente.

    E esse projeto nunca termina.

    Share
    Recommended for you
    Itaú - Java com Inteligência Artificial
    Nublify - Primeiros passos em IA e Cloud
    IBM Bob: IA de Nível Empresarial para Desenvolvedores e Tech Leaders
    Comments (0)
    Recommended for youIBM Bob: IA de Nível Empresarial para Desenvolvedores e Tech Leaders