Я начал проект, который включает как минимум три репозитория на GitHub.
Одним из репозиториев является общий дамп документации и примеров, а два других содержат реализацию двух программ, которые составляют основу проекта.
Должен ли я использовать GitHub Organization для обработки такой конфигурации?
Или я должен просто выбросить все это на свой счет вместе с дюжиной других, совершенно не связанных репозиториев?
Ответы:
Начните с репозиториев в вашем личном кабинете. Оттуда, если / когда вещи растут и / или становятся популярными в сообществе, перенесите их в учетную запись организации.
Давайте посмотрим на некоторые из ваших вариантов:
Для получения дополнительной информации о функциях GitHub Organization, обязательно прочитайте:
Блог GitHub: Представляем организации
Если вам когда-либо приходилось управлять несколькими учетными записями GitHub, вам нужна была панель управления для конкретной компании, вы хотели добавить соавторов, доступных только для чтения, или вам нужно было предоставить кому-то еще административный контроль над одним из ваших репозиториев, вы полюбите организации.
Исходя из вашего вопроса, я не могу сказать, подходит ли вам Организация (моя интуиция говорит мне «нет») , но, возможно, просмотр некоторых реальных примеров поможет вам принять ваше решение.
Вот несколько примеров организаций GitHub, на которые мне интересно посмотреть:
https://github.com/gruntjs
Это один из моих любимых примеров учетной записи организации с открытым исходным кодом. Меня больше всего впечатляют соглашения об именах, используемые для репозиториев (то есть, по сути, grunt/это основное репозиторий, а все связанные ядро / код вклада / плагины / задачи находятся в grunt-xxxx/репозиториях).
https://github.com/github
Вероятно, стоит взглянуть на собственную организацию GitHub. Счет. Соглашения об именах, используемые для репозиториев, не такие строгие, как у Гранта (IMHO), но, тем не менее, это хороший пример. О, и сейчас, вероятно, самое подходящее время, чтобы указать на вкладку «Участники» , поскольку вы не получаете это для личных учетных записей или репозиториев.
https://github.com/twbs
Twitter Bootstrap. Я думаю, что это хороший пример организации. аккаунт только с несколькими репозиториями (обратите внимание на один репо с более чем 58 000 звезд). Также обратите внимание, что Bootstrap имеет пять участников (на момент написания этой статьи), но эти пять ответственны за безумно популярный репозиторий (в отличие от 214 членов организации GitHub ).
Еще несколько общих примеров:
https://github.com/yeoman : инструменты сборки.
https://github.com/h5bp : шаблон HTML5.
https://github.com/nprapps : пример новостной индустрии.
Как вы уже упоминали, вы можете создать репозитории внутри своей личной учетной записи и перейти оттуда.
Будут ли вам нужны сотрудники?
GitHub Help: Сотрудничество / Как добавить соавтора?
Как видите, добавление соавторов довольно безболезненно.
Исходя из вашего вопроса, эта опция звучит так, как вы хотите.
Вы можете создать один репозиторий и использовать ветки для организации связанных частей кода.
Я не думаю, что большинство людей согласятся, что это лучший способ организовать ваш код :
С другой стороны, ничто не говорит о том, что вы не можете организовать связанные фрагменты кода с использованием веток.
Одно из личных неудобств, связанных с этой техникой, заключается в том, что графический интерфейс / интерфейс GitHub покажет вам следующее сообщение:
... при просмотре веток, отличных от вашей master(т. е. если ваша ветка впереди / сзади в коммитах).
Подсказка: если вы используете более свежую версию Git, вы можете получить определенные ветки, используя git clone -b mybranch --single-branch git://sub.domain.com/repo.git:
Связанные с:
Должен ли я использовать GitHub Organization для обработки такой конфигурации? Или я должен просто выбросить все это на свой счет вместе с дюжиной других, совершенно не связанных репозиториев?
Вы можете использовать комбинацию всего вышеперечисленного. Например:
Настройте организацию для «... общего дампа документации и примеров, а две другие содержат реализацию двух программ, которые составляют основу проекта».
Используйте свой личный аккаунт для "... дюжины других, совершенно не связанных репозиториев"
Используйте ветки для демонстрационных страниц gh-pages, соответствующего кода и / или документации.
Также стоит упомянуть, что вы можете использовать WIKI хранилища для документации: