verto

verto.sh

Sua porta de entrada para a colaboração de código aberto.

---

Entre no mundo da fonte aberta com verto.sh ! Escolhemos cuidadosamente projetos populares com questões fáceis de atingir, tornando simples para os desenvolvedores encontrarem um novo ou primeiro projeto para contribuir. Verto.sh é mais do que apenas uma lista - é uma plataforma. É onde os iniciantes podem fazer sua primeira contribuição, os fundadores podem construir uma equipe sólida e os mantenedores podem encontrar novos colaboradores.

A comunidade de código aberto está sempre acolhendo novos talentos, mas começar pode parecer difícil. Verto.sh facilita. Ao mostrar os recém-chegados as cordas e conectá-las a projetos que precisam de uma mão, estamos ajudando não apenas os indivíduos, mas todo o movimento de código aberto.

Com o Verto.Sh , dê o primeiro passo na codificação colaborativa e faça parte de algo maior. Seu código hoje pode ser o começo de algo incrível na comunidade de código aberto.

Adicionando um novo projeto

Você pode adicionar um novo projeto em verto.sh , basta seguir estas etapas:

• Para manter a qualidade dos projetos em Verto.sh , verifique se o repositório que você deseja adicionar atende os seguintes critérios:

  • Para os repositórios do GitHub : ele tem pelo menos três problemas com a good first issue ou outros rótulos definidos no config.json (consulte labels e o final do provedor GitHub ).

  • Para repositórios do GitLab : ele tem pelo menos três problemas com o rótulo quick win ou outros rótulos definidos no config.json (consulte labels e o final do provedor GitLab ).

  • Tem pelo menos 10 colaboradores.

  • Tem pelo menos 1000 estrelas.

  • Ele contém um readme.md com instruções de configuração detalhadas para o projeto e um contribuindo.md com diretrizes para novos colaboradores.

  • É mantido ativamente (última atualização há menos de 1 mês).

• Para repositórios do GitHub : adicione o caminho do seu repositório (no owner/name do formato e ordem lexicográfica) a config.json dentro do provedor GitHub .

• Para repositórios do GitLab : adicione o ID do seu repositório (no formato <project path>|<project id> ) a config.json dentro do provedor GitLab .

• Crie uma nova solicitação de tração. Adicione o link à página de problemas do repositório na descrição do PR. Depois que a solicitação de tração for mesclada, as alterações estarão ao vivo no verto.sh.

Como funciona?

Verto.sh usa o Next.js, React e TypeScript. Os dados mostrados no site são carregados a partir do arquivo Data.json, que é gerado por uma função em dados/utils.ts. Ele consulta as APIs do Github e Gitlab para buscar questões dos repositórios listados em config.json. Os rótulos definidos no config.json são usados para filtrar problemas para os repositórios.

Como configurar o projeto localmente

Para contribuir com novos recursos e alterações no site, você deseja executar o aplicativo localmente. Siga estas etapas:

1. Bifurcar o repositório, cloná -lo localmente, crie uma nova ramificação para trabalhar em um recurso específico ou correção de bugs sem afetar o ramo principal do repositório. Verifique se você tem uma versão recente do Node.js instalada no seu computador.
2. Você pode usar o Data.json incluído como dados fictícios ou pode executar npm run prebuild para buscar os dados mais recentes do GitHub: para isso, você precisará definir a variável de ambiente GH_PAT como um token de acesso pessoal (PAT) válido. Aviso: repositórios que não usam os critérios listados acima (consulte as regras em data.jsonare são removidas automaticamente do script config.json quando o script [data.json] data/data.json) é executado.
3. Inicie o servidor de desenvolvimento e abra o aplicativo no seu navegador.

 # install the dependencies
$ npm install
# start the development server
$ npm run dev

É bom saber quando você se compromete: o projeto contém um gancho pre-commit que executa linters automaticamente para garantir a qualidade do código!