Skip to content

Latest commit

 

History

History
81 lines (59 loc) · 5.03 KB

boaspraticas.md

File metadata and controls

81 lines (59 loc) · 5.03 KB
Raw

Manual de boas práticas de tradução

Objetivos deste Manual de tradução:

  • Ensinar;
  • Facilitar;
  • Padronizar;
  • Agilizar.

OBSERVAÇÕES INICIAIS:

  1. Criar uma ramificação (fork) do projeto original na sua conta pessoal do GitHub;
  2. Sempre enviar suas mudanças como Pull Requests;
  3. Não aprove seu próprio Pull Request, por mais que seja pouca coisa ou esteja cem por cento certo, pode ser que alguém ache algo que você pode melhorar ou corrigir;
  4. Caso haja dúvidas, peça ajuda aos membros mais ativos.

Ferramentas para auxílio:

  • Editores de texto: Notepad++ / Atom (você pode fazer uso de outro editor de texto de sua preferência). (1)
  • Aplicativo do GitHub para computador: GitHub Desktop. (2)
  • WinMerge. (3)

(1) Editores de texto

Estes programas lhe permitem fazer modificações nos arquivos da tradução.

(2) GitHub Desktop

Este é o programa que vai lhe permitir (e auxiliar) adicionar novas traduções ao repositório oficial, como também atualizar seu próprio repositório.

(3) WinMerge

Este programa lhe permite fazer comparações entre até três arquivos, para verificar possíveis alterações entre eles.

COMEÇANDO A TRADUZIR

Criando uma conta no GitHub

  1. Para começar a traduzir, se você ainda não possuir uma conta no GitHub, você irá precisar criar uma em GitHub;
  2. Preencha os campos de usuário (Username), Email (Email address) e senha (Password);
  3. Escolha o tipo de conta que será criada. Clique em Individual e depois Choose Free;
  4. Em seguida desça a página, clique em Complete setup e verifique o email de confirmação enviado para o email que você colocou no registro.

Criando seu próprio repositório

  1. Acesse o repositório oficial e procure a opção Fork no menu superior esquerdo. Ela está localizada logo após as opções Unwatch e Unstar;
  2. No pop-up que irá aparecer, clique no seu nome de usuário (para o qual você quer criar o repositório) e espere o repositório ser criado.

Mantendo seu repositório atualizado com o repositório oficial

  1. Se o seu repositório apresenta alguma mensagem do tipo: This branch is behind Ludeon:master, então está na hora de atualizá-lo. Para atualizar seu repositório clique em Compare, localizado ao lado da mensagem de alerta;
  2. Provavelmente você irá receber a mensagem There isn't anything to compare. Clique em Try switching the base para trocar as ordem de envio (em vez de enviar para o oficial, você vai pegar do oficial), se o link Try switching the base não estiver presente, mude a ordem manualmente clicando na lista base repository: e head repository:, de modo que o seu repositório esteja na esquerda e o repositório oficial na direita;
  3. Clique em Create new pull request;
  4. Adicione o título e a descrição do Pull request e clique em Create pull request;
  5. Em seguida desça toda a página e clique em Merge pull request;
  6. E por último, clique em Confirm merge. Pronto, seu repositório foi atualizado.

Abrindo os programas para tradução

  1. Após ter instalado o GitHub Desktop, abra-o;
  2. A tela de inicio do GitHub Desktop irá aparecer, faça login com sua conta e clique em Clone a repository from the internet...;
  3. Selecione o seu repositório criado, e clone o mesmo. Exemplo: https://github.com/(usuario)/RimWorld-PortugueseBrazilian;
  4. Pronto, você configurou o GitHub Desktop;
  5. Em seguida, basta abrir a pasta da tradução baixada pelo GitHub Desktop com seu editor de texto e começar a traduzir. Caminho da pasta (padrão): C:\Users(usuário)\Documents\GitHub\RimWorld-PortugueseBrazilian.

Enviando traduções para seu repositório

  1. Volte ao GitHub Desktop e localize um espaço em branco no canto inferior direito;
  2. Em Summary (required) digite o título da atualização (geralmente a versão do jogo);
  3. Em Description descreva suas mudanças feitas na tradução;
  4. Clique em Commit to master;
  5. Clique em Pull origin para enviar as traduções para seu repositório.

Enviando traduções do seu repositório para o repositório oficial

  1. Abra a página do seu repositório. Exemplo: https://github.com/(usuario)/RimWorld-PortugueseBrazilian;
  2. Clique em New pull request.
  3. Deixe a ordem dos repositórios de modo que o repositório oficial fique na esquerda, e o seu repositório na direita. Assim você irá enviar atualizações do seu repositório, para o repositório oficial.
  4. Clique em Create pull request.
  5. Adicione um título e a descrição das mudanças.
  6. Clique em Create pull request novamente.
  7. Aguarde para que suas alterações sejam aprovadas.