Как правильно оформить несколько разных, но с одинаковым функционалом проектов?

Question

[Spooky 2020]

Для примера есть пара консольный скриптов, на PHP, на JS (для Node) делающих абсолютно одно и тоже и с одинаковыми настройками для запуска (то есть просто версия для тех кто использует PHP и версия для любителей Node).
Как их лучше разместить? Создавать разные репозитории или держать в одном, общем? По идее разделение правильнее,
но смущает дублирование readme.md и документации. Или для доков следует создать дополнительный репозиторий?

Comments

[Сергей Кузнецов]

Никакой проблемы нет в разных репозиториях. А документацию легко синхронизировать между ними, если она по сути одинакова, но различается мелкими деталями.

Для примера, так сосуществуют официальная книга ProGit на английском и множество её локализаций.
Языки разные, но суть одна Книга не закончена и продолжает дополняться. И параллельно дорабатываются переводы. CI/CD тоже независимые. Когда в оригинале происходят изменения, мы без проблем актуализируем перевод. И наоборот, бывает что находим проблему и правим её в русском варианте, а потом предлагаем аналогичную правку в оригинал.

Answer 1

[Василий Банников]

Тоже за то чтобы иметь два раздельных репозитория - хоть они и делают одно и то же, но продукты всё-таки разные.
Да и CI/CD, если таковой будет, сделать будет легче.
И контрибуторам будет легче вкатиться - не все же знают одновременно и js и php.

Документацию действительно можно вынести в отдельную репу/сайт (сам бы так и сделал)

Как пример проекта, который сделан по такой логике - playwright.
API одинаковый, документация одна, вендор один, но реализован на Java, Python, C#, JS, и каждая реализация в своём репозитории.

А чтобы репозитории были более-менее сгруппированы - на гитхабе можно создать аккаунт организации

Comments

[Spooky 2020]

Спасибо! Playwright очень удачный пример.

И контрибуторам будет легче вкатиться - не все же знают одновременно и js и php.

действительно - в этом случае однозначно нужно разделять.