Notatka tłumacza
To jest tłumaczenie pliku contributing.md. Oto link do różnic w stosunku do AVA master (jeśli klikniesz na link, nie możesz znaleźć pliku contributing.md spośród zmodyfikowanych plików można zatem wywnioskować, że tłumaczenie jest aktualne).
✨ Dziękujemy za Twój wkład w AVA ! ✨
Należy pamiętać, że ten projekt został opublikowany z Code of conduct. Uczestnicząc w tym projekcie, zgadzasz się przestrzegać jego warunków.
Tłumaczenia: English, Español, Italiano, 日本語, Português, Русский, 简体中文
Jako użytkownik AVA jesteś idealnym kandydatem, aby pomóc nam ulepszyć naszą dokumentację: poprawki literówek, poprawki błędów, lepsze wyjaśnienia, więcej przykładów itp. Otwarte problemy dotyczące rzeczy, które można poprawić. Pomóż przetłumaczyć nasze dokumenty. Cokolwiek, nawet ulepszenia wprowadzone w tym dokumencie.
Użyj etykiety docs aby znaleźć sugestie dotyczące tego, czego chcielibyśmy zobaczyć więcej w dokumentacji.
Niektóre problemy powstają z brakujących, niemożliwych do odtworzenia lub po prostu nieprawidłowych informacji. Pomóż nam ułatwić ich rozwiązywanie. Zarządzanie problemami zajmuje dużo czasu, z twoją pomocą możemy poświęcić więcej czasu na naprawianie błędów i dodawanie funkcji.
Zawsze jesteśmy zainteresowani innymi opiniami w dyskusjach na tematy. To dobra okazja, aby wpłynąć na przyszły kierunek AVA.
Etykieta question jest właściwym miejscem do prowadzenia bieżących dyskusji.
Możesz użyć etykiet, aby dowiedzieć się, gdzie możesz pomóc:
blockedgdzie potrzebujemy pomocy, aby odblokować sytuacjębugdla znanych błędów chcielibyśmy naprawićenhancementsą funkcje do dodaniaperformanceoferuje pomysły na poprawę wydajności AVA
Etykiety help wanted (prośba o pomoc) i good for beginner (dobre dla początkujących) są szczególnie przydatne.
Możesz znaleźć problem, który jest przypisany lub ma etykietę assigned. Sprawdź przed rozpoczęciem tego problemu, ponieważ prawdopodobnie ktoś inny nad nim pracuje.
Chcielibyśmy to poprawić issues priority (priorytet) pierwszy. Chcielibyśmy również zobaczyć postęp issues low-priority (niski priorytet). issues future to te, które chcielibyśmy mieć, ale nie od razu. Sprawdź je przed przystąpieniem do pracy, ponieważ w tej chwili możemy nie brać odpowiedzialności za te funkcje.
Jeśli aktualizujesz zależności, upewnij się, że używasz npm@5.6.0 i zezwól na aktualizację pliku package-lock.json.
Mamy chat. Przyjdź, śledź, porozmawiaj z nami i pomóż innym.
- Issues dotyczą problemów. Skorzystaj z naszego chat lub Stack Overflow po wsparcie.
- Sprawdź błąd w istniejących wyjściach przed otwarciem jednego.
- Pamiętaj o użyciu najnowszej wersji AVA.
- Użyj jasnego i opisowego tytułu (w języku angielskim).
- Podaj jak najwięcej informacji: kroki, aby odtworzyć problem, komunikat o błędzie, wersję Node.js, system operacyjny itp. (W języku angielskim).
- Im więcej czasu poświęcisz na napisanie swojego problemu, tym szybciej go rozwiążemy.
- Najlepszym sposobem na odroczenie wyniku jest udowodnienie go nieudanym testem.
- Nietrywialne zmiany należy najpierw omówić w kwestii: aby uniknąć wykonywania niepotrzebnej pracy.
- W przypadku ważnych zadań radzimy jak najszybciej przedstawić swoje prace społeczności w celu uzyskania ich opinii. Otwórz żądanie ściągnięcia, gdy tylko zrobisz minimum niezbędne, aby zademonstrować swój pomysł. Na tym wczesnym etapie nie martw się, jeśli rzeczy nie są idealne lub w 100% skończone. Dodaj przedrostek [WIP] w tytule i opisz, co jeszcze musisz zrobić. Dzięki temu osoby patrzące na to nie szukają drobiazgów ani nie zgłaszają ulepszeń, które już wiesz, że musisz wprowadzić.
- Nowym funkcjom muszą towarzyszyć testy i dokumentacja (w języku angielskim).
- Nie dodawaj zmian niezwiązanych z żądaniem ściągnięcia.
- Sprawdź (Lint) i przetestuj przed wysłaniem żądania ściągnięcia, uruchamiając
$ npm test. - Wyślij pull request branche, nie na mastera.
- Użyj jasnego i opisowego tytułu dla pull requestu i commitów.
- Napisz przekonujący opis, aby wyjaśnić, dlaczego powinniśmy zintegrować Twoje żądanie ściągnięcia. Twoim zadaniem jest nas przekonać. Odpowiedz na pytanie «dlaczego» jest wymagane i podaj przypadki użycia.
- Możemy poprosić Cię o zmianę żądania ściągnięcia. Nie jest konieczne otwieranie kolejnego żądania ściągnięcia. Po prostu zaktualizuj ten, który już istnieje.
Uwaga: przy modyfikowaniu kodu pamiętaj, że motto AVA (skradzione z Pythona) to jedna metoda zrobienia czegoś. Na przykład żądanie dodania aliasu do interfejsu API (w ten sposób) zostanie najprawdopodobniej odrzucone, jeśli nie zostaną dodane inne znaczące korzyści.
Czy chcesz wnieść swój pierwszy wkład w projekt typu open source? Nie szukaj dalej! AVA może być jednym z najbardziej przyjaznych projektów i społeczności. Przeczytaj post na blogu "Making your first contribution" aby zacząć poprawnie i zrobić swój pierwszy udział w AVA !
//Ten dokument został przetłumaczony z języka francuskiego