Começar a contribuir com o Blockly

O Blockly é de código aberto e é mantido principalmente por uma pequena equipe. Aceitamos contribuições de desenvolvedores de fora da equipe principal. Não há como criar todos os recursos solicitados ou corrigir todos os bugs informados sem a nossa comunidade. Esta seção contém guias gerais que podem ser úteis para você, especialmente se você for iniciante no desenvolvimento de código aberto.

Para informações específicas sobre o Blockly que você precisa ler antes de fazer uma contribuição, consulte as seções Como contribuir com o Core e Como contribuir com os Samples.

Qual repositório?

Um repositório contém todos os arquivos de um único projeto. O Blockly tem dois repositórios: "blockly core" e "blockly-samples".

O núcleo do Blockly é o repositório da biblioteca do Blockly. Use este repositório se quiser fazer uma mudança no comportamento principal do Blockly de uma forma que seja aplicada a todos os usuários da biblioteca.

Exemplos do Blockly (link em inglês) é o repositório de exemplos, plug-ins e codelabs. Use este repositório se você quiser criar ou modificar um plug-in, escrever um codelab ou criar ou modificar um exemplo.

Passo a passo

Estas são as etapas gerais que você vai seguir sempre que fizer uma mudança.

  1. Instale o Git e o Node, seguindo os links na seção Ferramentas.
  2. Bifurque e clone o repositório. O GitHub tem um tutorial maravilhoso sobre como bifurcar um repositório. Para aplicar a Blockly, basta substituir todas as instâncias de octocat/Spoon-Knife por google/blockly ou google/blockly-samples, dependendo do repositório em que você quer trabalhar.
  3. Sincronize sua bifurcação. O GitHub também oferece um tutorial para sincronizar uma bifurcação.
  4. Confira a ramificação principal. No núcleo do Blockly, essa é a ramificação develop. No blockly-samples, este é o ramo master.
  5. Instale dependências e crie ferramentas executando npm install no diretório raiz.
  6. Crie uma nova ramificação executando git checkout -b myBranchName em um terminal. O nome precisa ajudar você a lembrar do que está trabalhando.
  7. Faça as mudanças.
  8. Valide suas mudanças seguindo o guia para core ou samples.
  9. Salve as alterações com git commit -am "fix: My commit message". Saiba mais sobre as mensagens de confirmação.
  10. Envie suas alterações para o GitHub com git push origin myBranchName.
  11. Abra uma solicitação de pull quando o código estiver pronto. Um membro da equipe do Blockly vai analisar suas mudanças e mesclar com o Blockly se elas forem aprovadas. Para mais informações, consulte o processo de revisão de relações públicas.