Я хотів би внести свій внесок у певний проект у GitHub . Я повинен роздрібнити його? Відділити його? Що рекомендується і як це зробити?

В ідеалі ви:

1. Розкладіть проект
2. Зробіть одну чи кілька добре прокоментованих та чистих комісій у сховище. Тут ви можете створити нову гілку, якщо ви змінюєте більше однієї частини чи функції.
3. Виконайте запит на виклик у веб-інтерфейсі github.

якщо це новий запит на функцію, не запускайте кодування спочатку. Не забудьте опублікувати проблему, щоб обговорити нову функцію.

Якщо функція добре обговорюється і є якийсь +1, або власник проекту затвердив її, призначте проблему собі, тоді виконайте дії, описані вище.

Деякі проекти не використовуватимуть систему запиту. Зверніться до автора чи списку розсилки щодо найкращого способу повернення коду до проекту.

Щоб додати відповідь Ян , після того, як ви роздрібнили проект, ви зможете розвиватися в будь-якій галузі, яку ви хочете (новій або одній з оригінального проекту)

Пам'ятайте:

• додайте оригінальний проект як віддалений (інша форма ' origin', оскільки це originбуло б ваше власне репо, результат вилки)
• перезавантажте свою гілку вгорі гілки оригінального репо-файлу, який ви хочете зробити.
  Важливо, що ваш запит на тягнуть результат швидкого злиття вперед.
  Дивіться, наприклад:
  • " Витягніть нові оновлення з оригінального сховища 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кнопку
• Клацніть на ньому та вкажіть необхідні деталі

lornajane має публікацію в блозі, яка добре пояснює процес: http://www.lornajane.net/posts/2010/contributing-to-projects-on-github

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

Я б запропонував такий робочий процес:

1. Розкладіть сховище (через веб-інтерфейс GitHub: кнопка "Fork")
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. Ви маєте щось цінне додати до проекту?