Bem-vindo! ??
Good First Issue é uma iniciativa para selecionar escolhas fáceis de projetos populares, para que os desenvolvedores que nunca contribuíram para o código aberto possam começar rapidamente.
Os mantenedores de código aberto estão sempre procurando envolver mais pessoas, mas os novos desenvolvedores geralmente acham que é um desafio se tornar um contribuidor. Acreditamos que fazer com que os desenvolvedores corrijam problemas superfáceis remove a barreira para futuras contribuições. É por isso que existe o Good First Issue.
Você está convidado a adicionar um novo projeto na Good First Issue, e nós encorajamos todos os projetos - antigos e novos, grandes e pequenos.
Siga estas etapas simples:
Nosso objetivo é restringir projetos para novos contribuidores de código aberto. Para manter a qualidade dos projetos em Good First Issue, certifique-se de que seu repositório GitHub atenda aos seguintes critérios:
Tem pelo menos três edições com o rótulo good first issue . Este rótulo já está presente em todos os repositórios por padrão. Caso contrário, você pode seguir as etapas aqui.
Tem pelo menos 10 colaboradores.
Ele contém um README.md com instruções detalhadas de configuração para o projeto e um CONTRIBUTING.md com diretrizes para novos contribuidores.
É mantido ativamente.
Adicione o caminho do seu repositório (em ordem lexicográfica) em data/repositories.toml.
Crie uma nova solicitação pull. Adicione o link para a página de problemas do repositório na descrição do PR. Depois que a solicitação pull for mesclada, as alterações estarão disponíveis em goodfirstissue.dev.
Good First Issue tem dois componentes – o aplicativo front-end desenvolvido com Nuxt.js e um script de preenchimento de dados escrito em Python.
Para contribuir com novos recursos e alterações para o site, você deseja executar o aplicativo localmente. Siga estas etapas:
Clone o projeto localmente. Certifique-se de ter o Python 3 e uma versão recente do Node.js instalada em seu computador.
Faça uma cópia dos arquivos de dados de amostra para seu aplicativo local usar e renomeie-os com o nome de arquivo esperado pelo aplicativo. Esta etapa é importante porque o aplicativo front-end não funcionará sem esses arquivos de dados.
$ cp dados/generated.sample.json dados/generated.json $ cp dados/tags.sample.json dados/tags.json
Crie o aplicativo front-end e inicie o servidor de desenvolvimento.
$ bun install # instala as dependências$ bun dev # inicia o servidor de desenvolvimento
O aplicativo deve abrir no seu navegador.
