O versionamento com Git e GitHub deixou de ser uma prática exclusiva de desenvolvedores de software e tornou-se uma competência essencial em ambientes corporativos, acadêmicos e de uso p
Em equipes de trabalho, a capacidade de rastrear quem alterou o quê, quando e por qual motivo transforma projetos analíticos em ativos auditáveis e colaborativos, eliminando o caos de arquivos duplicados, versões conflitantes enviadas por e-mail e retrabalho causado por alterações não documentadas.
Contexto de uso - Versionamento de Código
Na academia, o versionamento é um pilar da ciência reprodutível: ao publicar o repositório junto ao artigo ou relatório, o pesquisador permite que qualquer pessoa verifique, reproduza e expanda a análise com precisão, o que aumenta a credibilidade do trabalho e facilita a colaboração entre grupos de pesquisa geograficamente distribuídos.
Contexto de uso - Versionamento de Código
No uso pessoal, o Git funciona como uma memória técnica estruturada do próprio desenvolvimento profissional. Cada projeto versionado no GitHub é um registro público do raciocínio analítico, das decisões de código e da evolução das habilidades ao longo do tempo, funcionando simultaneamente como portfólio técnico e como proteção contra perda de trabalho.
Contexto de uso - Versionamento de Código
Para quem está construindo carreira em ciência de dados, estatística ou áreas correlatas, manter projetos bem organizados e versionados no GitHub é hoje um diferencial concreto em processos seletivos, pois permite que recrutadores e gestores avaliem não apenas o resultado final, mas a qualidade do processo que o gerou.
Git
Git é um sistema de controle de versão desenvolvido originalmente para permitir que equipes de desenvolvimento trabalhassem de forma colaborativa em grandes projetos de software.
Sua principal função é gerenciar a evolução de um conjunto de arquivos - chamado de repositório - de forma organizada e segura.
Git
Para fins didáticos, o Git pode ser comparado ao recurso de “controlar alterações” de editores como o Microsoft Word, porém com funcionalidades significativamente mais avançadas.
Na ciência de dados, o Git gerencia não apenas código-fonte, mas também bases de dados, documentos, relatórios e scripts - com rastreabilidade completa de cada mudança.
Os verdadeiros ganhos surgem na colaboração em equipe: o Git reduz a complexidade da comunicação entre membros, tornando o processo mais fluido e integrado ao cotidiano de análise.
GitHub
Plataformas como GitHub, GitLab e Bitbucket atuam como serviços de hospedagem para projetos baseados em Git.
Elas permitem armazenar repositórios remotamente, compartilhar projetos e colaborar em tempo real - como uma “nuvem inteligente” para projetos versionados.
GitHub
Esses serviços oferecem interfaces amigáveis, facilitando o uso do Git mesmo para usuários menos experientes.
Diferentes membros da equipe podem sincronizar alterações e propor melhorias com segurança e rastreabilidade.
Mesmo em projetos individuais, a hospedagem remota é recomendada: em caso de conflito ou erro local, a cópia remota permite restaurar versões estáveis rapidamente.
GitHub
O foco deste material será o uso do GitHub, por ser a plataforma mais popular e amplamente suportada. Os conceitos apresentados também se aplicam ao GitLab, Bitbucket e soluções similares.
A distinção entre repositórios públicos e privados pode ser ajustada conforme a necessidade. O GitHub permite a criação de repositórios privados gratuitamente.
Benefícios do uso do Git e GitHub
O uso combinado proporciona acesso facilitado ao código e maior colaboração. Projetos no GitHub podem ser explorados publicamente, clonados ou baixados - qualquer pessoa pode visualizar os arquivos diretamente pela interface web, sem conhecimento prévio em Git.
Benefícios do uso do Git e GitHub
Usuários mais experientes podem acompanhar o desenvolvimento de projetos, propor melhorias por meio de forks e pull requests, e participar ativamente da evolução de pacotes e análises.
Note
**“A colaboração é a razão mais convincente para gerenciar um projeto com Git e GitHub.** Minha definição de colaboração inclui a participação prática de várias pessoas, incluindo o seu ‘eu’ do passado e do futuro.”
Jenny Bryan
Módulo 2
Instalação e Configuração
1. Instalação ou atualização do R e RStudio
Mantenha seus softwares atualizados.
Utilizar versões desatualizadas pode gerar dificuldades evitáveis, especialmente na integração entre R, RStudio, Git e GitHub.
Caso os softwares ainda não tenham sido instalados, siga os procedimentos descritos no Módulo de Instalação do R e do RStudio.
2. Registro de uma conta no GitHub
O processo é simples e gratuito. Acesse https://github.com e clique em Sign up.
O GitHub solicitará nome de usuário, e-mail e senha. Após o registro, é possível criar repositórios públicos e privados imediatamente.
2. Registro - Boas práticas para o nome de usuário
Recomendado:
Incorporar o nome real quando possível
Reutilizar nomes já usados em outras plataformas
Usar letras minúsculas e hífen para separar palavras
Escolher um nome curto, único e atemporal
2. Registro - Boas práticas para o nome de usuário
O que evitar:
Nomes genéricos ou reservados como admin, user, null, na
Letras maiúsculas para separar palavras
Referências temporárias a universidades, empresas ou localizações
O nome de usuário é sua identidade pública no GitHub. Uma vez escolhido, alterá-lo pode gerar inconsistências em links e referências.
3. Instalação do Git
Você precisa do Git instalado para que o RStudio possa utilizá-lo. Caso já esteja instalado, considere atualizar para uma versão recente.
Create project as subdirectory of: escolha o diretório local
O RStudio clona o repositório e cria um .Rproj automaticamente.
Método 3 - Criando direto do RStudio
Ideal para iniciar um novo projeto em R com controle de versão desde o início e publicá-lo no GitHub.
No RStudio: File > New Project > New Directory > New Project
Nomeie o projeto, escolha o local e marque “Create a git repository”.
Método 3 - Ativando o Git
Com o projeto aberto, ative o Git com o pacote {usethis}:
# usethis::use_git()
Método 3 - Publicando no GitHub
Em seguida, publique o projeto diretamente no GitHub:
# usethis::use_github()
Método 3 - Repositório criado no GitHub
O repositório é criado automaticamente e fica disponível no GitHub.
Módulo 4
Fluxo de Trabalho com Git no RStudio
Versionamento de código no RStudio
O RStudio oferece uma interface gráfica integrada ao Git que facilita o versionamento de arquivos sem o uso do terminal.
Essa funcionalidade pode ser ativada em projetos existentes por meio do caminho:
Tools > Project Options > Git/SVN
Configurações do painel Git/SVN
Enable version control interface for RStudio projects
Quando marcado, ativa a aba Git dentro do RStudio sempre que você abrir um projeto versionado. É por essa aba que você vai executar commit, push, pull, visualizar diferenças e gerenciar arquivos.
Sign git commits
Permite assinar commits com uma chave GPG - recurso avançado, usado em ambientes de segurança. Para uso padrão, pode ser deixado desmarcado.
Configurações do painel Git/SVN
Git executable
Indica o caminho do executável do Git no computador (ex: C:/Program Files/Git/bin/git.exe). Se estiver vazio, clique em Browse e localize manualmente.
SSH key
Mostra se existe uma chave SSH configurada - alternativa ao uso de token via .Renviron para autenticar com o GitHub.
O Painel Git no RStudio
Após ativar o Git, o painel aparece no canto superior direito do RStudio.
Elementos do Painel Git - Parte 1
Elemento
Função
Staged
Checkbox para selecionar arquivos para o commit
Status
M (modificado), A (adicionado), D (deletado), ? (não rastreado)
Diff
Visualiza as alterações linha por linha
Elementos do Painel Git - Parte 2
Elemento
Função
Commit
Abre a janela para registrar o commit
Pull
Baixa commits do repositório remoto
Push
Envia commits para o GitHub
Elementos do Painel Git - Parte 3
Elemento
Função
History
Exibe o histórico visual de commits
Branch
Lista e permite criar branches
More
Opções avançadas e acesso ao terminal Git
Conceitos importantes - Commit
Um commit é como tirar uma fotografia do estado atual do projeto. Ele registra uma versão dos arquivos naquele momento, com uma mensagem descritiva que explica o que foi feito.
Cada commit tem um identificador único
É possível voltar a qualquer versão anterior com base nos commits
Um commit é local - ainda não está no GitHub
Conceitos importantes - Push
O push envia os commits locais para o repositório remoto no GitHub.
É como sincronizar o projeto local com o servidor
Outros colaboradores só terão acesso ao seu trabalho após o push
Necessário ter o repositório remoto configurado corretamente
Commit salva localmente. Push envia ao GitHub.
Conceitos importantes - Pull
O pull baixa as alterações do repositório remoto para a máquina local.
Deve ser executado antes de começar a trabalhar, garantindo que você está na versão mais atualizada
Evita conflitos e sobreposição de alterações feitas por outras pessoas
Pense no pull como: quero as atualizações do meu time antes de começar a editar.
Conceitos importantes - Stage
Antes de fazer um commit, os arquivos precisam ser adicionados à staging area (área de preparação).
Permite selecionar quais arquivos farão parte do próximo commit
Você pode preparar apenas parte das alterações antes de salvar definitivamente
No RStudio, isso é feito marcando o checkbox ao lado do arquivo na aba Git
Conceitos importantes - Repositório
Um repositório é o local onde o histórico completo do projeto é armazenado, incluindo todos os commits, arquivos e ramificações.
Pode ser local (na sua máquina) ou remoto (no GitHub)
Contém toda a evolução do projeto, permitindo rastrear e comparar versões ao longo do tempo
Conceitos importantes - Branch
Uma branch (ramificação) permite trabalhar em uma nova funcionalidade ou correção sem afetar o código principal.
A branch principal normalmente se chama main ou master
Outras branches podem ser criadas para testar ideias ou desenvolver recursos
Após o trabalho concluído, as alterações podem ser integradas à main por meio de um merge
Folha de dicas - Interface Git no RStudio
Primeiro commit - Passo 1
Após criar o projeto com Git ativo, vá até a aba Git no RStudio. Você verá os arquivos com o símbolo ? (untracked), indicando que ainda não estão versionados.
Marque o checkbox ao lado dos arquivos que deseja incluir - isso é chamado de adicionar ao stage.
Primeiro commit - Passo 2
Clique em Diff para comparar o conteúdo atual dos arquivos com o que está salvo. Linhas em verde foram adicionadas; linhas em vermelho foram removidas.
Primeiro commit - Passo 3
Clique em Commit. Uma nova janela será aberta. No campo de mensagem, insira um texto descritivo sobre o que foi feito.
Primeiro commit - Passo 4
Clique em Commit para confirmar. Uma janela de log será exibida indicando que o commit foi realizado com sucesso.
Primeiro commit - Passo 5
Clique em Push (seta para cima) para enviar as alterações ao repositório no GitHub.
Primeiro commit - Passo 6
Abra o repositório no GitHub e confira as alterações. O arquivo enviado aparecerá com a mensagem de commit registrada.
Boas práticas - Mensagens de commit
Mensagens corretas:
Adiciona função de limpeza de dados ausentes
Corrige bug no cálculo de média ponderada
Refatora script de visualização por região
Mensagens incorretas:
Update
Correções
asdf
Mudanças
Boas práticas - Estrutura recomendada
tipo: descrição curta (até 50 caracteres)
Descrição detalhada do que foi feito e por que.
Pode conter múltiplas linhas quando necessário.
