rhymus

Rimus

Um projeto de jogo de rima de código aberto projetado para novos desenvolvedores e colaboradores iniciantes.

Notícias

Em 22 de janeiro, a filial master-vue está agora pronta para contribuições! Você pode usar o ramo master existente como modelo para como o aplicativo VUE deve ser desenvolvido. Incluídos no projeto VUE estão os testes de unidade (usando jest) e vuex (para gerenciamento de estado).

Melhorias adicionais no ramo master ainda são bem -vindas. O React terá sua própria filial criada em fevereiro.

Como desenvolvedor profissional de Vue, estarei particularmente envolvido com contribuições e quaisquer perguntas que surgirem sobre a filial master-vue , portanto, fique à vontade para pedir conselhos e fazer esses PRs!

Jogabilidade

O Rhymus é um jogo de código aberto que exibirá cartas com frases. Cada frase terá uma palavra que não faz sentido, mas rima com uma palavra que tem. Por exemplo, 'eu tenho um nevoeiro de estimação'. -> Resposta: 'cachorro'. Um cronômetro oferece 30 segundos para completar o maior número possível.

Projeto

Este projeto passará por duas fases . O primeiro será uma compilação inicial usando um back-end de nó e HTML, CSS e JS front-end. Para a primeira compilação, não haverá implementação React/Redux.

Depois que a primeira compilação estiver completa e completa, duas novas ramificações serão criadas nas quais o projeto será reformado usando o React e o Vue .

Contribuições

Este projeto está começando do zero, então há amplas oportunidades para contribuir. A maneira mais rápida de contribuir é verificar a guia Projetos e ver quais prioridades existem . Caso contrário, qualquer um dos seguintes é uma ótima maneira de contribuir:

• Editando o ReadMe
• Criando novos arquivos para a estrutura do projeto
• Reestruturar o projeto para cumprir as melhores práticas
• Codificando qualquer um dos front-end ou back-end
• Arquivos de teste de codificação
• Oferecendo estilo alternativo
• Sugerindo melhores práticas para o gerenciamento do github (incluindo diretrizes de contribuição)

Diretrizes de contribuição

Quando você contribuir, use as seguintes diretrizes:

• Nomeie sua filial de uma maneira que reflita o que você planeja fazer ('implementar-rolagem')
• Forneça informações detalhadas em sua solicitação de tração sobre o que você fez e por que isso é feito dessa maneira
• Em sua solicitação de tração, reflita sobre seu código e inclua comentários sobre se pode precisar refatorar ou se algo foi particularmente difícil
• Inclua testes com sua contribuição, se aplicável

Este é um projeto de código aberto para desenvolvedores de todos os níveis de experiência. Mostre cortesia comum e forneça feedback construtivo sempre que possível.

Guia completo para iniciantes

Se você é totalmente novo em contribuir para projetos de código aberto ou usar o Git, siga este pequeno guia para fazer seu primeiro PR. Lembre-se de que existem muitas maneiras de concluir isso, mas isso foi projetado para ser muito básico e fácil de seguir. Se não for, corrija -o!

1. Clique no garfo no canto superior direito para fazer uma cópia deste repositório.
2. Supondo que você tenha instalado o Gitbash, clique com o botão direito do mouse na pasta de documentos (onde você armazena pastas de projeto) e abra no Gitbash.
3. Digite git clone https://[email protected]/username/rhymus .
4. Abra esta pasta no seu IDE (como o Código do Visual Studio).
5. No seu terminal (aberto a partir da parte superior suspensa do terminal no código VS), digite git checkout -b add-puzzle .
6. À esquerda, abra a pasta SRC e depois a pasta JS e abra quebra -cabeças.js .
7. Siga o padrão que você vê lá e crie um novo quebra -cabeça de rima e salve suas alterações.
8. No seu terminal, digite git commit -m "added new puzzle" .
9. No seu terminal, digite git remote add origin https://[email protected]/username/rhymus .
10. No seu terminal, digite-se git push origin add-puzzle .
11. No GitHub, vá para o seu repositório e selecione a ramificação de adição de suplemento .
12. Clique no novo botão Solicitação de puxar e preencha -o.

Feito!

Mas espere, o que aconteceu?

1. A forking criou uma cópia do repositório na sua conta do GitHub. 2 - 3) Usando o Gitbash, você coloca uma cópia desse repositório na máquina local, onde pode abrir e editar todos os arquivos. A clonagem é apenas uma cópia exata do repositório que o URL aponta. 4 - 5) Você abriu a pasta e criou uma nova filial. O checkout se move para uma nova ramificação e o -b significa que ele criará a nova ramificação. 6 - 7) Você adicionou um novo quebra -cabeça após o padrão, esperançosamente!
2. Você cometeu seu salvamento! Isso significa que você salvou oficialmente e preparou suas mudanças para ser empurrado oficialmente para o seu repositório. O -m significa uma mensagem anexada à confirmação para que você e outras pessoas possam ver o que é o compromisso.
3. Você adicionou um controle remoto! Este é um lugar para o qual você pressionará regularmente. Você adicionará apenas um único controle remoto uma vez, depois o apelido (geralmente origem) que você pode usar em vez de digitar o URL longo sempre.
4. Você empurrou o seu salvamento local para o seu repositório no ramo de suplemento! Seu compromisso está oficialmente em seu repositório on -line! 11 - 12) Você fez uma solicitação de tração, que é uma solicitação para o repositório original (este) aceitar suas alterações na base!

Talvez você esteja pensando: "Espere, e se meu código for terrível? Ou quebrado? Ou completamente errado?" Não importa! Ao fazer uma solicitação de tração, seu código será revisado antes de ser mesclado no repositório oficial. Se precisar de alterações, você receberá comentários explicando o que, como e por que mudar! Depois de fazer alterações, você poderá empurrar novamente e ele atualizará automaticamente sua solicitação de tração (portanto, não feche -a se não for aprovada imediatamente). Cometer esses erros é exatamente como você aprenderá.

Se você está se sentindo ousado, faça mais alterações, comete, empurre e relações públicas!

Sobre o autor

Sou um desenvolvedor de software de pilha completa atualmente trabalhando em Tóquio, Japão. Eu juntei este projeto para solidificar e compartilhar meu conhecimento de programação. Também ofereço programas de metaia para programadores iniciantes em bloqueios de três meses, então fique à vontade para me verificar no LinkedIn e entrar em contato comigo se você estiver interessado em encontrar um mentor.