# Edições externas e versões

Como as alterações de outros editores, scripts e do Git chegam a um projeto compartilhado, quando o Oleafly pergunta antes de enviá-las e como o histórico compartilhado, os pontos de verificação e o Git se combinam na hora de restaurar.

Um projeto compartilhado é uma pasta comum no seu computador. Outros programas podem alterar os arquivos dela, e o Oleafly traz essas alterações para o projeto compartilhado.

## Outros editores e scripts

Quando outro editor, um formatador, um script ou uma ferramenta de linha de comando salva um arquivo na pasta do projeto, o Oleafly percebe e envia a alteração a todos. Funciona mesmo enquanto outras pessoas estão digitando nesse arquivo.

O Oleafly compara o arquivo salvo com a versão que ele gravou por último ali. Só o que o outro programa alterou é aplicado. O texto que os seus coautores digitaram nesse meio-tempo continua onde está. Um editor que salva a cada segundo enquanto outros digitam também não é problema.

## Alterações grandes perguntam primeiro

Algumas operações alteram muitos arquivos de uma vez: trocar de branch do Git, fazer um pull, descompactar um arquivo compactado sobre o projeto ou restaurar uma versão antiga. O Oleafly retém uma alteração assim e pergunta antes de ela chegar a todos. Ele pergunta quando 10 ou mais arquivos mudam de uma vez, ou quando pelo menos 3 arquivos mudam e representam 30 por cento ou mais dos arquivos do projeto.

Um aviso acima do editor diz quantos arquivos mudaram fora do Oleafly e pergunta se as alterações devem ser enviadas a todos ou mantidas locais:

- **Enviar** envia as alterações. Elas são mescladas com o que os outros estiverem digitando.
- **Manter local** mantém esses arquivos como estão só neste computador. Todos os outros ficam com a versão compartilhada. Se você editar um desses arquivos depois, só a sua nova edição é enviada.

### Quando a pasta do projeto desaparece

Se a pasta do projeto fica indisponível, por exemplo em uma unidade que você desconectou, o Oleafly pausa a sincronização desse projeto em vez de tratar todos os arquivos como excluídos. Ele avisa isso, e a sincronização recomeça quando a pasta volta.

## Git em um projeto compartilhado

O histórico do Git não é compartilhado. Cada pessoa pode manter o próprio repositório no projeto e fazer commit e push para o próprio remoto. Veja [Git e controle de versão](/docs/git-history/).

O Git altera os arquivos no disco, e esses são os arquivos que o Oleafly compartilha. Fazer checkout de outra branch ou um pull envia esses arquivos a todos, depois da pergunta acima quando muitos arquivos mudam. Se você só quer olhar outra branch, escolha **Manter local** ou use um clone separado fora do projeto compartilhado.

### A visualização de comparação é somente leitura

Em um projeto compartilhado, as comparações no Controle de versão são somente leitura. A comparação diz “Em um projeto compartilhado, esta comparação é somente leitura. Edite o arquivo no editor.” Faça a sua alteração no editor, onde ela é mesclada com o que todos os outros digitam.

## Histórico de versões

Um projeto compartilhado tem um [histórico compartilhado](/docs/collaboration/history/) que todos nele veem: cada alteração, quem a fez e quando, com versões que você pode abrir, comparar, nomear e restaurar.

Cada pessoa também mantém o próprio histórico do projeto:

- Os [pontos de verificação salvos](/docs/checkpoints/) são criados no seu computador depois de compilações bem-sucedidas, como em qualquer projeto.
- Os [commits do Git](/docs/git-history/) são os que você faz no seu próprio repositório.
- **Revisar**, na **Atividade**, mostra o que os outros alteraram enquanto você estava fora. Leia [Quando você se reconecta](/docs/collaboration/offline/#when-you-reconnect).

## Restaure uma versão

Para voltar a um ponto do histórico compartilhado, abra a versão em **Histórico** e escolha **Restaurar este arquivo** ou **Restaurar o projeto inteiro**. Leia [Restaure um arquivo ou o projeto inteiro](/docs/collaboration/history/#restore-a-file-or-the-whole-project).

A restauração dos seus próprios pontos de verificação e commits funciona como em qualquer projeto. Abra **Versionamento → Pontos de verificação salvos** ou **Versionamento → Histórico do Git** e escolha **Restaurar** na versão que você quer. Proprietários e editores podem restaurar.

Em um projeto compartilhado, restaurar altera os arquivos compartilhados para todos. O Oleafly envia o texto restaurado como uma edição, então o que os outros estiverem digitando naquele momento é mesclado com ele e não se perde. Se a restauração altera muitos arquivos, você recebe antes a pergunta **Enviar** ou **Manter local**.

Como todos recebem o resultado, avise os seus coautores antes de restaurar.

## Restaure um arquivo excluído

Os arquivos excluídos esperam em **Excluídos recentemente** no painel **Colaboração em tempo real**. Selecione **Restaurar** para trazer um de volta para todos. Leia [Excluídos recentemente](/docs/collaboration/files/#recently-deleted).
