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 fora da equipe principal. Não é possível criar todos os recursos solicitados ou corrigir todos os bugs relatados sem a ajuda da nossa comunidade. Esta seção contém guias gerais que podem ser úteis, especialmente se você não tiver experiência com 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 Contribuir com o Core e Contribuir com exemplos.

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 Blockly. Use este repositório se quiser fazer uma mudança no comportamento principal do Blockly de uma forma que se aplique a todos os usuários da biblioteca.

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

Guia detalhado

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. Copie e clone o repositório. O GitHub tem um tutorial incrível sobre como bifurcar um repositório. Para aplicar ao Blockly, basta substituir todas as instâncias de octocat/Spoon-Knife por RaspberryPiFoundation/blockly ou RaspberryPiFoundation/blockly-samples, dependendo do repositório em que você quer trabalhar em.
  3. Sincronize seu fork. O GitHub também oferece um tutorial para sincronizar um fork.
  4. Confira a ramificação principal. No núcleo do Blockly, essa é a ramificação develop. Em blockly-samples, essa é a ramificação master.
  5. Instale dependências e ferramentas de build executando npm install no diretório raiz.
  6. Crie uma ramificação executando git checkout -b myBranchName em um terminal. O nome deve 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 mudanças com git commit -am "fix: My commit message". Leia mais sobre mensagens de commit.
  10. Envie suas mudanças 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 mesclá-las ao Blockly se forem aprovadas. Para mais informações, consulte Processo de revisão de RP.