[Sarlug] Как помочь открытому проекту - технические детали?

[Sarlug] Как помочь открытому проекту - технические детали?

[Алексей Карпов]

Приветствую.

Я хотел бы оказать посильную помощь нескольким открытым проектам, но не
знаю как - подскажите, как правильно оформить мои изменения в коде, чтобы
они были рассмотрены, как правильно их отсылать, подкиньте какие-нибудь
ссылки на howto на эту тему!

Re: [Sarlug] Как помочь открытому проекту - технические детали?

[Konstantin Baev]

Алексей Карпов пишет:
> Приветствую.
>
> Я хотел бы оказать посильную помощь нескольким открытым проектам, но не
> знаю как - подскажите, как правильно оформить мои изменения в коде, чтобы
> они были рассмотрены, как правильно их отсылать, подкиньте какие-нибудь
> ссылки на howto на эту тему!
>
> _______________________________________________
> Sarlug mailing list
> Sarlug@lists.lug.ru
> https://lists.lug.ru/mailman/listinfo/sarlug
1. Выяснить какую багтрекинговую систему использует проект и запостить 
туда багу

Пример (ALTLinux): https://bugzilla.altlinux.org/

2. Выяснить какую систему контроля версий использует проект и если у вас 
имеется в открытом доступе своя подобная система, то склонировать 
проект, провести изменения, и выложить. А может быть это можно сделать и 
на ресурсе проекта. Далее - запостить багу со ссылкой на свое решение.

Пример (ALTLinux): http://git.altlinux.org/
Вот, например мои там пакеты: 
http://git.altlinux.org/people/kipruss/packages/

3. Как оформить изменения - сгенерить патч.

man patch
man diff
man gendiff


Самый простой способ - допустим у вас 2 директории - a (исходная) и b (с 
вашими правками).

Команда

$ diff -Nur a b > some-patch-name.patch

сгенерит вам патч, который вы можете выслать, прикрепив к баге или письму

4.Тупо написать письмо или в рассылку проекта или просто разработчикам 
на том языке, который они поймут.

--
Konstantin Baev (Kipruss)

Re: [Sarlug] Как помочь открытому проекту - технические детали?

[Nikita V. Borodikhin]

Доброго времени суток, Алексей!

Алексей Карпов пишет:
> Я хотел бы оказать посильную помощь нескольким открытым проектам, но не
> знаю как - подскажите, как правильно оформить мои изменения в коде, чтобы
> они были рассмотрены, как правильно их отсылать, подкиньте какие-нибудь
> ссылки на howto на эту тему!

Самый простой вариант:
* скачать исходный код, распаковать
   например, в директорию project-1.2.3
* сделать полную копию директории
   например, cp -r project-1.2.3 project-1.2.3.my
* внести изменения в копию
* diff -pruN project-1.2.3 project-1.2.3.my > my.123.patch
   Это значит: оформлять изменения в формате patch, в unified-виде,
               рекурсивно, включать новые файлы
* отослать патч аттачем в список рассылки, описав в тексте письма,
   что за проблема решается и каким образом

В небольших проектах этого будет достаточно, дальше подскажут.
Дальше можно:
* оформлять код в виде, принятом для данного проекта. Правила могут
   называться по-разному: coding rules, style guide, source code policy
* посылать изменения не относительно последнего релиза, а относительно
   текущей ветки разработки (cvs, svn, bazaar, git и т.д.)
* посылать изменения в баг-трекинг проекта (bugzilla, mantis...)
   вместо списка рассылки


Ссылки:
  http://www.kegel.com/academy/opensource.html
  http://www.wikihow.com/Become-a-Free-Software-Hacker


С уважением,
-- 
Nikita V. Borodikhin, NIKB-RIPN BNV7-RIPE
Registered Linux user #256562 with the Linux Counter