Должен ли репозиторий также служить веб-сайтом проекта (по крайней мере, для небольших проектов)?
Это более философский вопрос, но такие вопросы здесь разрешены.
Как мы все знаем, существуют различные бесплатные хосты проектов. Общей чертой, вероятно, всех из них, является возможность ссылаться на внешний веб-сайт или даже управлять им.
Мой вопрос: как вы думаете, действительно ли нужен внешний веб-сайт?
Такое место, как GitHub, позволяет владельцам проекта создавать вики со скриншотами и т. Д. Тем не менее, такие места, как информационное окно программного обеспечения Википедии, рассматривают GitHub как репозиторий, ожидая, что официальная ссылка приведет к чему-то еще.
Почему? Может быть, большие проекты не хотят полагаться на сторонних разработчиков, таких как GitHub, но как насчет небольших проектов?
Зачем иметь 2 одинаковых веб-сайта, оба с одинаковой информацией, руководством и т. Д. (За исключением того, что один из них называется репозиторием)?
Что должно быть лучше для маркетинга?
И если вы выбираете внешний веб-сайт, не следует ли вам использовать вики репозитория, чтобы избежать вышеупомянутого дублирования?
Ответы
Для многих проектов README - это все, что нужно с точки зрения веб-сайта. Поскольку хосты репозиториев, такие как GitHub или Gitlab, будут отображать этот README с хорошей визуализацией, веб-сайт ничего не добавит. Это общий подход, вероятно, для подавляющего большинства открытого программного обеспечения.
Отдельный веб-сайт (возможно, в вашем собственном домене) имеет больше смысла, если вы хотите, чтобы у проекта была идентичность, которая меньше зависит от исходной службы хостинга, или если вы хотите отображать контент, выходящий за рамки того, что можно разумно поместить в README. . Итак, по сути, маркетинг или документация. Хотя исходный код веб-сайта может быть частью репозитория исходного кода, это не то же самое. Даже в визуализированной форме эти исходные файлы не совсем удобны для человека, например, ссылки могут быть неправильными, или GitHub может не полностью понимать синтаксис.
Однако я бы посоветовал вам держаться подальше от функции Wiki GitHub. С другой стороны, вики-страницы легко редактировать. Но по сравнению с реальным веб-сайтом их трудно найти, и они очень ограничены в возможностях навигации или тематики. Похоже, что наиболее удачное использование вики-сайтов GH - это база знаний проекта или своего рода блокнот. Эта вики никогда не будет служить целевой страницей для пользователей, поэтому вам необходимо связать вики из другого места (README и / или с веб-сайта).