Fazer commit e revisar as alterações do projeto

Sobre commits

Assim como ao salvar um arquivo que foi editado, um commit registra alterações em um ou mais arquivos no seu branch. O Git atribui a cada commit um ID exclusivo, denominado SHA ou hash, que identifica:

Cada uma das alterações feitas;
O momento em que as alterações foram feitas;
O autor das alterações.

Ao fazer um commit, você deve incluir uma mensagem que descreva brevemente as alterações. Você também pode adicionar um coautor em qualquer commit em que colaborar.

Se os commits que você cria em GitHub Desktop estiverem associados à conta errada no GitHub, atualize o endereço de e-mail na configuração do Git usando GitHub Desktop. Para obter mais informações, consulte "Configurar o Git para GitHub Desktop".

Escolher um branch e fazer alterações

Crie um branch ou selecione um branch existente clicando em Current Branch (Branch atual) na barra de ferramentas. Em seguida, selecione o branch na lista.
Usando seu editor de texto favorito, como o Atom, faça as alterações necessárias nos arquivos do seu projeto.

Escolhendo como mostrar diffs

Você pode alterar a maneira como os diffs são exibidos em GitHub Desktop para atender às suas necessidades de revisão.

Para mudar a forma como você vê os diffs, no canto superior direito da visão diff, clique em .

Para alterar a forma como o diff inteiro é exibido, em "Exibição do diff", selecione Unificado ou Separado. A visualização unificada mostra as alterações linearmente, enquanto a visualização separada mostra conteúdo antigo do lado esquerdo e novo conteúdo do lado direito.
Para ocultar as alterações de espaços em branco para que você possa se concentrar em alterações mais substantivas, selecione Ocultar alterações de espaços em branco.

Menu de opções do diff

Se você precisa ver mais do arquivo do que GitHub Desktop mostra por padrão, você pode expandir o diff.

Para ver as próximas linhas acima ou abaixo das alterações destacadas, clique na seta acima ou abaixo dos números de linha.
Para ver o arquivo inteiro, clique com o botão direito do mouse na visualização do diff e clique em Expandir todo o arquivo.

Selecionar alterações para inclusão em um commit

As alterações feitas nos arquivos via editor de texto e salvas no local também aparecerão no GitHub Desktop.

O ícone vermelho indica os arquivos removidos.
O ícone amarelo indica os arquivos alterados.
O ícone verde indica os arquivos adicionados.
Para acessar as alterações stashed, clique em Stashed Changes (Alterações stashed).
Para adicionar todas as alterações em todos os arquivos a um único commit, mantenha a caixa de seleção na parte superior da lista selecionada.
Para adicionar todas as alterações em um ou mais arquivos a um único commit, desmarque todas as caixas de seleção ao lado dos arquivos que você não quer incluir, deixando apenas os arquivos que você quer no commit. É possível alternar a caixa de seleção com as teclas Barra de espaços ou Enter depois de selecionar um arquivo.

Criar um commit parcial

Se um arquivo tiver várias alterações e você quiser incluir somente algumas no commit, será possível criar um commit parcial. O restante das alterações ficará intacto, de modo que você possa fazer outras modificações e commits. Essa opção permite fazer commits separados mais relevantes, como manter alterações de quebra de linha em um commit separado das alterações de código.

Para excluir linhas alteradas do seu commit, clique em uma ou mais linhas alteradas para que o azul desapareça. As linhas ainda em destaque em azul serão incluídas no commit.

Linhas desmarcadas em um arquivo

Descartar alterações

Se você tiver alterações não realizadas que não deseja manter, poderá descartar as alterações. Isso removerá as alterações dos arquivos no seu computador. Você pode descartar todas as alterações não realizadas em um ou mais arquivos ou pode descartar as linhas específicas que adicionou.

As alterações descartadas são salvas em um arquivo datado na Lixeira. Você pode recuperar as alterações descartadas até que a lixeira seja esvaziada.

Descartar alterações em um ou mais arquivos

Na lista de arquivos alterados, selecione os arquivos dos quais você deseja descartar as alterações desde o último commit. Para selecionar vários arquivos, clique shift e clique no intervalo de arquivos dos quais você deseja descartar as alterações.
Clique em Discard Changes (Descartar alterações) ou Discard Selected Changes (Descartar alterações selecionadas) para descartar as alterações em um ou mais arquivos ou clique em Discard All Changes (Descartar todas as alterações) para descartar alterações em todos os arquivos desde o último commit.
Para confirmar as alterações, revise os arquivos afetados e clique em Discard Changes (Descartar alterações).

Descartar alterações em uma ou mais linhas

Você pode descartar uma ou mais linhas alteradas que não foram confirmadas.

Observação: Descartar linhas únicas está desabilitado em um grupo de alterações que adiciona e remove linhas.

Para descartar uma linha adicionada, na lista de linhas alteradas, clique com o botão direito na linha que você deseja descartar e selecione Descartar linha adicionada.

Descartar uma única linha na caixa de diálogo de confirmação

Para descartar um grupo de linhas alteradas, clique com o botão direito na barra vertical à direita dos números de linha para as linhas que você deseja descartar e, em seguida, selecione Descartar linhas adicionadas.

Descartar um grupo de linhas adicionadas na caixa de diálogo de confirmação

Mensagem de commit e envio das alterações

Ao concluir as alterações que você decidiu fazer no commit, escreva a mensagem do commit e envie as alterações. Se o commit envolveu trabalho em colaboração, será possível atribuí-lo a mais de um autor.

Observação: Por padrão, GitHub Desktop fará o push da tag que você criar no seu repositório com o commit associado. Para obter mais informações, consulte "Gerenciando tags".

Na parte inferior da lista de alterações, no campo Summary (Resumo), digite uma mensagem de commit curta e significativa. Como alternativa, é possível adicionar mais informações sobre as alterações no campo Description (Descrição).
Para atribuir um commit a outro autor, você também pode clicar no ícone de adicionar coautores e digitar o nome dos usuários que pretende incluir.
No campo Description (Descrição), clique em Commit to BRANCH (Fazer commit para o BRANCH).
Se o branch com a qual você está tentando fazer commit estiver protegido, o desktop irá avisá-lo.
- Para mover as alterações, clique em alternar branches.
- Para confirmar suas alterações no branch protegido, clique em Commit para BRANCH.
Para obter mais informações sobre branches protegidos, consulte "Sobre branches protegidos".
Clique em Carregar origem para fazer push das suas alterações locais no repositório remoto.
Se você tiver um pull request baseado no branch no qual você está trabalhando, GitHub Desktop irá exibir o status das verificações que foram executadas para o pull request. Para obter mais informações sobre verificações, consulte "Visualização e reexecução de verificações no GitHub Desktop".

Se um pull request não tiver sido criado para o branch atual, GitHub Desktop dará a você a opção de criar um. Para obter mais informações, consulte "Criando um problema ou um pull request."