verto

Verto.sh

Ваши ворота в сотрудничество с открытым исходным кодом.

---

Зайдите в мир открытого исходного кода с Verto.sh ! Мы тщательно выбираем популярные проекты с простыми в борьбе с проблемами, что позволяет разработчикам найти новый или первый проект, в который можно внести свой вклад. Verto.sh - это больше, чем просто список - это платформа. Именно там, где новички могут внести свой первый вклад, основатели могут построить солидную команду, и сопровождающие могут найти новых участников.

Сообщество с открытым исходным кодом всегда приветствует новый талант, но начинание может чувствовать себя тяжелым. verto.sh облегчает. Показывая новичкам веревки и соединяя их с проектами, которые нуждаются в руке, мы помогаем не только людям, но и все движение с открытым исходным кодом.

С Verto.sh сделайте первый шаг в совместное кодирование и станьте частью чего -то большего. Ваш код сегодня может стать началом чего-то удивительного в сообществе с открытым исходным кодом.

Добавление нового проекта

Вы можете добавить новый проект в Verto.sh , просто следуйте этим шагам:

• Чтобы поддерживать качество проектов в Verto.sh , пожалуйста, убедитесь, что репозиторий, который вы хотите добавить, соответствует следующим критериям:

  • Для репозиториев GitHub : у него есть как минимум три выпуска с good first issue или другими этикетками, определенными в config.json (см. labels и конец поставщика GitHub ).

  • Для репозиториев Gitlab : у него есть как минимум три выпуска с ярлыком quick win или других ярлыков, определенных в config.json (см. labels и конец поставщика GitLab ).

  • У него есть не менее 10 участников.

  • У этого есть не менее 1000 звезд.

  • Он содержит readme.md с подробными инструкциями по настройке для проекта и Appling.md с руководящими принципами для новых участников.

  • Это активно поддерживается (последнее обновление менее 1 месяца назад).

• Для репозиториев GitHub : добавьте путь вашего хранилища (в owner/name и лексикографический заказ) в config.json внутри поставщика GitHub .

• Для репозиториев Gitlab : добавьте идентификатор вашего репозитория (в формате <project path>|<project id> ) в config.json внутри поставщика GitLab .

• Создайте новый запрос. Пожалуйста, добавьте ссылку на страницу проблем репозитория в описании PR. Как только запрос на тягу будет объединен, изменения будут жить на Verto.sh.

Как это работает?

Verto.sh использует Next.js, React и TypeScript. Данные, показанные на веб -сайте, загружаются из файла data.json, который генерируется функцией в Data/utils.ts. Он запрашивает API Github и Gitlab, чтобы извлечь проблемы из репозиториев, перечисленных в config.json. Метки, определенные в config.json, используются для фильтрации проблем для репозиториев.

Как настроить проект локально

Чтобы внести новые функции и изменения на веб -сайт, вы хотели бы запустить приложение локально. Пожалуйста, следуйте этим шагам:

1. Разбейте репозиторий, клонируйте его локально, создайте новую ветку для работы над определенной функцией или исправлением ошибки, не влияя на основную ветвь репозитория. Убедитесь, что на вашем компьютере установлена недавняя версия Node.js.
2. Вы можете использовать прилагаемые Data.json в качестве фиктивных данных, или вы можете запустить npm run prebuild чтобы получить последние данные от GitHub самостоятельно: для этого вам нужно будет установить переменную среды GH_PAT в действительный токен личного доступа GitHub (PAT). УВЕДОМЛЕНИЕ: Репозитории, не обработанные критериям, перечисленным выше (см. Правила в data.jsonare автоматически удаляются из config.json, когда работает скрипт [data.json] data/data.json).
3. Запустите сервер разработки и откройте приложение в вашем браузере.

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

Приятно знать, когда вы совершаете: проект содержит подготовку pre-commit , который автоматически запускает Linters, чтобы обеспечить качество кода!