Explorando Front End: Repositório de Temas e Explicações

Bem-vindo ao repositório "Explorando Front End"! Este repositório tem como objetivo coletar e explicar diversos temas relacionados à front end, de acordo com sugestões e contribuições dos alunos.

Como Contribuir

Abrindo uma Issue

As issues são utilizadas para sugerir novos temas ou reportar problemas encontrados no repositório. Para abrir uma nova issue, siga estes passos:

1. Navegue até a aba de Issues do repositório.
2. Clique em "New Issue".
3. No título da issue, escreva um resumo claro e conciso do tema que deseja ver explicado.
   • Exemplo de título: "Explicação sobre Algoritmos de Ordenação"
4. Na descrição, forneça detalhes adicionais sobre o que você gostaria de aprender sobre o tema.
   • Exemplo de descrição: "Gostaria de entender como funcionam os algoritmos de ordenação mais eficientes e exemplos de quando usá-los."
5. Etiquetas (Labels):
   • Adicione etiquetas relevantes como "novos temas", "algoritmos", "estruturas de dados", etc., para ajudar na organização.

Contribuindo com Explicações (Pull Requests - PRs)

Você pode contribuir com o repositório adicionando explicações detalhadas para os temas sugeridos. Siga estes passos para contribuir via PR:

1. Faça um fork deste repositório para a sua conta do GitHub.
2. Clone o repositório forkado para o seu computador:

   git clone URL_DO_SEU_FORK

3. Escolha um tema existente nas issues ou sugira um novo tema abrindo uma nova issue.
4. Crie uma nova branch para suas alterações:

   git checkout -b nome_da_sua_branch

5. Crie uma pasta com o nome do tema dentro do diretório apropriado (por exemplo, temas/algoritmos-ordenacao).
6. Dentro dessa pasta, adicione um arquivo README.md com a sua explicação.
   • Use subpastas como examples para adicionar exemplos de código didáticos.
7. Adicione, comite e envie as alterações para o GitHub:

   git add .
   git commit -m "Adicionar explicação sobre [Nome do Tema]"
   git push origin nome_da_sua_branch

8. Abra um pull request do seu repositório forkado para este repositório.
   • No título do PR, especifique o tema que você está contribuindo.
   • Na descrição, forneça uma visão geral das suas alterações e explique por que essa contribuição é valiosa.

Regras para Issues

• Utilize títulos claros e descritivos.
• Forneça detalhes suficientes na descrição para facilitar a compreensão do problema ou sugestão.
• Utilize etiquetas apropriadas para categorizar as issues (ex.: "novos temas", "bugs", etc.).

Regras para Pull Requests (PRs)

• Crie uma nova branch para cada PR e nomeie-a de forma descritiva.
• Siga a estrutura de diretórios e arquivos do repositório.
• Adicione exemplos de código simples e didáticos dentro da pasta examples quando apropriado.
• Certifique-se de que todos os arquivos desnecessários estejam listados no .gitignore para evitar a inclusão acidental de arquivos não relacionados.

Licença

Este projeto está licenciado sob a Licença MIT. Veja o arquivo LICENSE para mais detalhes.

---