GitHub Организации для проекта, охватывающего несколько репозиториев?

11

Я начал проект, который включает как минимум три репозитория на GitHub.

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

Должен ли я использовать GitHub Organization для обработки такой конфигурации?
Или я должен просто выбросить все это на свой счет вместе с дюжиной других, совершенно не связанных репозиториев?

git github organization repository jcora
источник

Ответы:

14

Краткий ответ ...

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

Длинный ответ ...

Давайте посмотрим на некоторые из ваших вариантов:

1. Организация:

Для получения дополнительной информации о функциях GitHub Organization, обязательно прочитайте:

Блог GitHub: Представляем организации

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

Исходя из вашего вопроса, я не могу сказать, подходит ли вам Организация (моя интуиция говорит мне «нет») , но, возможно, просмотр некоторых реальных примеров поможет вам принять ваше решение.

Вот несколько примеров организаций GitHub, на которые мне интересно посмотреть:

  1. https://github.com/gruntjs
    Это один из моих любимых примеров учетной записи организации с открытым исходным кодом. Меня больше всего впечатляют соглашения об именах, используемые для репозиториев (то есть, по сути, grunt/это основное репозиторий, а все связанные ядро ​​/ код вклада / плагины / задачи находятся в grunt-xxxx/репозиториях).

  2. https://github.com/github
    Вероятно, стоит взглянуть на собственную организацию GitHub. Счет. Соглашения об именах, используемые для репозиториев, не такие строгие, как у Гранта (IMHO), но, тем не менее, это хороший пример. О, и сейчас, вероятно, самое подходящее время, чтобы указать на вкладку «Участники» , поскольку вы не получаете это для личных учетных записей или репозиториев.

  3. https://github.com/twbs
    Twitter Bootstrap. Я думаю, что это хороший пример организации. аккаунт только с несколькими репозиториями (обратите внимание на один репо с более чем 58 000 звезд). Также обратите внимание, что Bootstrap имеет пять участников (на момент написания этой статьи), но эти пять ответственны за безумно популярный репозиторий (в отличие от 214 членов организации GitHub ).

    1. https://github.com/twitter : основной аккаунт Twitter на GitHub.

Еще несколько общих примеров:

  1. https://github.com/yeoman : инструменты сборки.

  2. https://github.com/h5bp : шаблон HTML5.

  3. https://github.com/nprapps : пример новостной индустрии.

2. Личный кабинет

Как вы уже упоминали, вы можете создать репозитории внутри своей личной учетной записи и перейти оттуда.

Будут ли вам нужны сотрудники?

GitHub Help: Сотрудничество / Как добавить соавтора?

Как видите, добавление соавторов довольно безболезненно.

Исходя из вашего вопроса, эта опция звучит так, как вы хотите.

3. Репо с несколькими ветками:

Вы можете создать один репозиторий и использовать ветки для организации связанных частей кода.

Я не думаю, что большинство людей согласятся, что это лучший способ организовать ваш код :

С другой стороны, ничто не говорит о том, что вы не можете организовать связанные фрагменты кода с использованием веток.

Одно из личных неудобств, связанных с этой техникой, заключается в том, что графический интерфейс / интерфейс GitHub покажет вам следующее сообщение:

введите описание изображения здесь

... при просмотре веток, отличных от вашей master(т. е. если ваша ветка впереди / сзади в коммитах).

Подсказка: если вы используете более свежую версию Git, вы можете получить определенные ветки, используя git clone -b mybranch --single-branch git://sub.domain.com/repo.git:

Связанные с:

4. Гибридный подход:

Должен ли я использовать GitHub Organization для обработки такой конфигурации? Или я должен просто выбросить все это на свой счет вместе с дюжиной других, совершенно не связанных репозиториев?

Вы можете использовать комбинацию всего вышеперечисленного. Например:

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

  2. Используйте свой личный аккаунт для "... дюжины других, совершенно не связанных репозиториев"

  3. Используйте ветки для демонстрационных страниц gh-pages, соответствующего кода и / или документации.

Заметки):

Также стоит упомянуть, что вы можете использовать WIKI хранилища для документации:

mhulse
источник