Comece a contribuir com o Blockly

O Blockly é de código aberto e é mantido principalmente por uma equipe pequena. Contribuições de desenvolvedores de fora da equipe principal são bem-vindas. Não há como construirmos todos os recursos solicitados ou corrigirmos bugs informados sem nossa comunidade. Esta seção contém guias gerais que podem ser úteis, especialmente se você não tiver experiência em desenvolvimento com código aberto.

Para ver informações específicas do Blockly que você precisa ler antes de fazer uma contribuição, consulte as seções Contribuir para o núcleo e Contribuir para amostras.

Qual repositório?

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

O Blockly core é o repositório da biblioteca Blockly. Use esse repositório se quiser fazer uma alteração no comportamento principal do Blockly para que seja aplicada a todos os usuários da biblioteca.

Amostras do Blockly é o repositório de amostras, plug-ins e codelabs. Use esse repositório se quiser criar ou modificar um plug-in, criar um codelab ou criar ou modificar uma amostra.

Passo a passo

Estas são as etapas gerais que você seguirá sempre que fizer uma alteração.

  1. Instale o Git e o nó seguindo os links na seção Ferramentas.
  2. Ramifique e clone o repositório. O GitHub tem um tutorial maravilhoso sobre como bifurcar um repositório (em inglês). Para aplicá-la ao bloqueio, 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 fornece um tutorial para sincronizar uma bifurcação.
  4. Confira a ramificação principal. No núcleo bloqueado, essa é a ramificação develop. Em blockly-samples, essa é a ramificação 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 ajudará você a lembrar em que está trabalhando.
  7. Faça as alterações.
  8. Valide as alterações seguindo o guia dos exemplos ou de núcleo.
  9. Salve suas alterações com git commit -am "fix: My commit message". Leia mais sobre mensagens de confirmação.
  10. Envie suas alterações para o GitHub usando git push origin myBranchName.
  11. Abra uma solicitação de envio quando o código estiver pronto. Um membro da equipe do Blockly analisará suas alterações e as mesclará no Blockly se elas forem aprovadas. Para mais informações, consulte Processo de análise de relações públicas.