Zasady współpracy

Zawsze będziemy potrzebować Deweloperów przy ulepszaniu SpongeAPI. Nie ma takiej rzeczy jak perfekcyjny projekt i każda funkcja może być zawsze ulepszana. Jeśli jesteś Deweloperem i jesteś chętny do pomocy to nie wahaj się. Po prostu upewnij się, że postępujesz z naszymi wytycznymi.

Informacja

Programiści Rozwojowi, którzy zademonstrują swoją determinację i stałą chęć współtworzenia projektu, mogą zostać zaproszeni przez Liderów Zespołu do przyłączenia się według uznania kierowników. Nie mamy jeszcze żadnej formalnej procedury. Prosimy o nie dopytywanie się, gdyż w odpowiednim czasie zapytamy Cię to.

Ogólne kroki

  1. Setup your workspace as described in Przygotowanie do tworzenia.
  2. Upewnij się, że jesteś zaznajomiony z Git i GitHub. Jeśli twoja wiedza wymaga odświeżenia to zerknij tutaj: Praca z Git(Hub)
  3. Sprawdź, jakie istnieją problemy w repozytoriach SpongeAPI, SpongeCommon, SpongeForge, SpongeVanilla i SpongeDocs. To prawdopodobnie ktoś już pracuje nad tym samym. Możesz również sprawdzić oznaczone zagadnienia jako „chciał pomóc” w celu oznajmienia się z problemami w których może potrzebujemy twojej pomocy.

Informacja

Please don’t submit pull requests for small, non-functional changes such as fixing typos or renaming variable names. Instead, join #sponge on IRC (irc.esper.net) or join #spongedev on IRC (irc.esper.net) and we’ll change it together with the other smaller changes. You can also add it to our list of Minor Issues on GitHub.

  1. If the issue requires a bigger change you may want to submit the issues without the necessary changes first, so we can confirm the issue and know that you’re working on fixing it. You should also create a draft pull request or comment with ~wip so we can already start reviewing them.
  2. Zforkuj projekt, sklonuj go i wprowadź zmiany w dodatkowej gałęzi.
  3. Sprawdź swoje zmiany (upewnij się, że się kompilują!), zcommituj i wstaw je do swojego forka.
  4. Wykonaj swoje żądanie Pull-Request wraz z krótkim podsumowaniem wprowadzonych przez Ciebie zmian oraz uzasadnieniem, dlaczego powinno być to zrobione w taki, a nie inny sposób.
  5. Jeżeli stworzysz dodatkowe zmiany, stwórz nowy commits do twojej gałęzi. Nie ukrywaj swoich zmian, gdyż sprawia to, że bardzo trudno zobaczyć, co zmieniono w porównaniu do poprzedniej wersji Pull Request.
  6. Upewnij się, że PR jest ponownie wyznaczone na najnowsze zmiany jeśli masz zamiar połączyć go do nowej gałęzi. Jeśli potrzebujesz pomocy do ponownego wyznaczenia to po prostu zapytaj!

Wskazówka

Jeśli nie masz pewności jaką gałąź (branch) należy oprzeć swoją pracę to przeczytaj o naszych Repository Branch Layout przed przesłaniem swojego PR.