Я хотел бы внести свой вклад в определенный проект в GitHub . Должен ли я это раскошелиться ? Разветвить это? Что рекомендуется и как это сделать?

В идеале вы:

1. Форк проект
2. Сделайте один или несколько хорошо прокомментированных и чистых коммитов в хранилище. Вы можете создать новую ветку здесь, если вы изменяете более одной детали или функции.
3. Выполните pull-запрос в веб-интерфейсе github.

если это новый запрос Feature, не начинайте сначала кодирование. Не забудьте опубликовать вопрос, чтобы обсудить новую функцию.

Если функция хорошо обсуждена, и некоторые +1 или владелец проекта одобрил ее, назначьте проблему для себя, а затем выполните действия, описанные выше.

Некоторые проекты не будут использовать систему запросов на выборку. Узнайте у автора или списка рассылки, как лучше вернуть ваш код в проект.

Чтобы добавить к ответу Янна , после того, как вы разбудили проект, вы можете разрабатывать в любой отрасли, которую хотите (новую или одну из исходного проекта)

Запомни:

• добавить исходный проект как удаленный (другая форма ' origin', так как originэто будет ваш собственный репозиторий, результат форка)
• перебазируйте вашу ветку поверх ветки исходного репо, которую вы хотите внести.
  Важно, чтобы ваш запрос на вытягивание привел к ускоренному слиянию.
  Смотрите, например:
  • Msgstr " Вытащить новые обновления из исходного репозитория Github в разветвленный репозиторий Github ".
  • « Обновление разветвленного репозитория на github »
  • " Git рабочая вилка с обновлениями "

Чтобы добавить к ответам Яна и VonC, это хороший ресурс от самих github: http://help.github.com/forking/

Также обязательно посмотрите на правую боковую панель под заголовком «Сотрудничество».

Существует большое Railscast видео здесь , что проведет вас через процесс. В нем также есть несколько полезных советов, таких как показ того, как определить, над какой веткой вы хотели бы работать при добавлении, с помощью тестов, субмодулей и т. Д.

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

У Github есть много способов сотрудничества с проектом. Модель, используемая в большинстве проектов, представляет собой модель запроса на извлечение. Я начал проект, чтобы помочь людям сделать первый запрос на GitHub. Вы можете сделать практический урок, чтобы сделать свой первый PR здесь

Рабочий процесс прост как

• Репо в github
• Клонируйте репо на свою машину
• Сделайте ветку и внесите необходимые изменения
• Поместите ваши изменения в ваш форк на GitHub git push origin branch-name
• Перейдите на свой форк на GitHub и увидите Compare and pull requestкнопку
• Нажмите на нее и укажите необходимые данные

Лорнайн имеет пост в блоге, который хорошо объясняет процесс: http://www.lornajane.net/posts/2010/contributing-to-projects-on-github

Технический рабочий процесс

Я бы предложил следующий рабочий процесс:

1. Форк репозитория (через веб-интерфейс GitHub: кнопка «Форк»)
2. В своем разветвленном хранилище скопируйте URL

3. Клон (в командной строке)

   git clone <url-from-your-workspace>

4. Введите каталог, который только что был создан, и создайте ветку

   cd <directory> git checkout -b <branchname>

5. Теперь внесите свои изменения

6. Вы можете создать один или несколько коммитов после каждого изменения:

   commit -a

7. Когда закончите, нажмите ваши изменения

   git push origin <branch>

8. В вашей командной строке вы должны увидеть URL для создания PR . Посетите URL и нажмите кнопку, чтобы создать PR.

9. Если нет, посетите репозиторий в браузере, и он предложит вам кнопку для создания запроса на извлечение.

Вот и все.

Итак, в основном, вы разветвили репозиторий в свою рабочую область, создали новую ветку и добавили эту новую ветку.

Если вы позже сделаете больше PR из того же клонированного репо, вам нужно синхронизировать (получить последние изменения из исходного репозитория), прежде чем создавать другую ветку для другого PR:

git checkout master
git remote add upstream <url-of-original-repo>
git pull upstream master

Другие соображения:

• проект может иметь Рекомендации по вкладу: найдите файл CONTRIBUTING.rst или .md
• Вы можете следовать руководству по кодированию для проекта
• Вы можете изложить свою идею в первую очередь
• Вы можете посмотреть вкладку «Запросы на извлечение» для проекта и проверить, есть ли открытый PR, объединенный PR

Эти предложения здесь, чтобы уберечь вас от необходимости вкладывать работу в PR, который не будет объединен. Если в проекте есть активность, и пиар слился, это хороший знак. Если есть рекомендации для участников, следуйте им.

Всегда будь вежливым. Помните, что сопровождающие проекта никоим образом не обязаны объединять ваш PR. У вас есть что добавить в проект?