W jaki sposób właściciel (właściciele) powinien zarządzać wkładami w projekt open source?

12

Jak zarządzać projektem open source (za pomocą usługi takiej jak GitHub), jak zareagujesz na następujące pytania:

Ktoś uprzejmie przesłał łatkę, aby dodać nową funkcję lub rozwiązać problem. Występuje jedna z następujących sytuacji:

  • Kod źródłowy nie spełnia jednej lub więcej konwencji nazewnictwa itp.
  • Wydaje mi się, że kod źródłowy można poprawić w określony sposób. Być może ten sam efekt można osiągnąć przy znacznie prostszym źródle, a może potrzebna byłaby inna przydatna funkcja.

Pytanie 1 Czy mogę zaakceptować przesłane źródło? (czy jest to możliwe w GitHub?)

Q2 Czy wszystkie takie wnioski należy odrzucić zgodnie z wytycznymi dotyczącymi przesyłania?

Pytanie 3 Jeśli tak, to w przypadku drugiego kwartału, co powiesz na naprawdę fajny pomysł, który został źle wdrożony? Czy jest dla mnie dopuszczalne, aby po prostu tworzyć własne?

Chcę zachęcić do wniesienia wkładu, ale jednocześnie ważne jest utrzymanie pewnego standardu.

open-source github Lea Hayes
źródło

Odpowiedzi:

7

Skonfiguruj, jeśli jeszcze tego nie zrobiłeś, dokument opisujący standardy projektu. Pamiętaj, aby nakreślić wszystko, co uważasz za ważne, gdy dodajesz kod do swojego projektu.

Następnie odpowiedz osobie, która dostarczyła kod ze szczegółami, że bardzo doceniasz wkład i że chcesz dołączyć łatkę, ale są pewne problemy. Podaj link do dokumentu i przytocz konkretne problemy, które widzisz. Następnie poproś tę osobę o naprawienie problemów i ponowne przesłanie kodu.

Jeremy Heiler
źródło
Myślę, że jądro Linuksa zawiera w tym scenariuszu obszar „zmian wymagających poprawy”.
seppo0010,
1
Na dłuższą metę przyniesie korzyści projektowi i całej społeczności, jeśli zachęcisz ludzi do poprawiania własnych zgłoszeń. Ale absolutnie w porządku jest samodzielne ponowne wdrożenie tej funkcji, pod warunkiem, że jesteś uprzejmy.
David Schwartz
1
Widziałem sporo projektów, które automatyzują niektóre z tych rzeczy za każdym razem, gdy prosisz o ściągnięcie.
Andrew T Finnell,
Tylko uwaga dla osób korzystających z GitHub, jeśli nazwiesz wyżej wymieniony dokument CONTRIBUTING, wówczas link do tego dokumentu pojawi się podczas przesyłania żądania ściągnięcia. Może pomóc zaoszczędzić trochę czasu z góry, jeśli ludzie będą w stanie samodzielnie rozwiązać typowe problemy.
Michael Mior
2

Jeśli nie ma zbyt wielu współautorów, a ten wkład jest dość cenny, możesz zaakceptować łatkę taką, jaka jest, a następnie, w następnym zatwierdzeniu, przepisz jej części samodzielnie lub sformatuj ponownie, aby potwierdzić standardy kodowania. - Następnie wyślesz do współpracownika wiadomość e-mail z linkiem do różnych wprowadzonych zmian. Mamy nadzieję, że współtwórca następnie przestudiuje różnicę i prześle lepszą łatkę następnym razem, której nie trzeba poprawiać.

Może to być dobry pomysł, jeśli nie napisałeś jeszcze żadnych Przewodników dla współautorów ani dokumentów w stylu kodowania . W rzeczywistości możesz kontynuować w ten sposób (akceptować i poprawiać łatki, przesyłać pocztą e-mail linki do diffów), dopóki nie zauważysz błędów popełnianych przez większość autorów. A następnie umieścisz tylko te błędy w Przewodniku dla współtwórców i Przewodniku stylizacji .

Jeśli robisz to w ten sposób, odpowiedzi na pytania od I do III będą następujące:

  • P1: Tak, edytuj przesłanie w kolejnym zatwierdzeniu
  • Q2: Nie dotyczy (założyłem, że nie napisałeś jeszcze żadnych wytycznych)
  • P3: Powiedz dzięki i przepisz go :-) (Być może nie ma sensu nakładać łatki, jeśli przy następnym zatwierdzeniu i tak ją przepiszesz)
KajMagnus
źródło