Przejdź do treści głównej

Przegląd współtworzenia

Nieoficjalne Tłumaczenie Beta

Ta strona została przetłumaczona przez PageTurner AI (beta). Nie jest oficjalnie zatwierdzona przez projekt. Znalazłeś błąd? Zgłoś problem →

Dziękujemy za zainteresowanie współtworzeniem React Native! Każdy wkład jest mile widziany - od komentowania i triagowania zgłoszeń, przez recenzowanie, aż po wysyłanie Pull Requestów. Naszym celem jest budowa żywego i inkluzywnego ekosystemu partnerów, głównych współtwórców i społeczności wykraczającego poza główne repozytorium React Native na GitHubie.

Witryna Open Source Guides zawiera zbiór zasobów dla osób, społeczności i firm, które chcą nauczyć się prowadzić i współtworzyć projekty open source.

Zarówno doświadczeni współtwórcy, jak i osoby nowe w open source znajdą szczególnie przydatne następujące przewodniki:

Kodeks postępowania​

Przypominamy, że od wszystkich współtwórców oczekuje się przestrzegania Kodeksu postępowania.

Polityka wersjonowania​

Aby w pełni zrozumieć system wersjonowania React Native, zalecamy zapoznanie się ze stroną Versioning Policy. Na tej stronie opisujemy, które wersje React Native są wspierane, jak często są wydawane oraz którą należy używać w zależności od okoliczności.

Sposoby współtworzenia​

Jeśli chcesz od razu zacząć współtworzyć kod, przygotowaliśmy listę dobrych pierwszych zadań zawierających błędy o stosunkowo ograniczonym zakresie. W miarę zdobywania doświadczenia i wykazywania zaangażowania w rozwój React Native, możesz uzyskać uprawnienia do zarządzania zgłoszeniami w repozytorium.

Istnieją też inne sposoby współtworzenia bez pisania ani linijki kodu. Oto kilka działań, w których możesz pomóc:

  1. Odpowiadanie na otwarte zgłoszenia i ich obsługa.

    Codziennie otrzymujemy wiele zgłoszeń, a niektórym może brakować niezbędnych informacji. Możesz pomóc, prowadząc użytkowników przez proces wypełniania szablonu zgłoszenia, prosząc o dodatkowe wyjaśnienia lub wskazując istniejące zgłoszenia pasujące do opisu problemu. Więcej o tym procesie znajdziesz na stronie Triaging GitHub Issues.

  2. Recenzowanie pull requestów do dokumentacji.

    Przeglądanie aktualizacji dokumentacji może być tak proste jak sprawdzanie pisowni i gramatyki. Jeśli natrafisz na sytuacje, które można lepiej wyjaśnić w dokumentacji, kliknij Edytuj u góry większości stron dokumentacji, aby rozpocząć własny wkład.

  3. Pomaganie w tworzeniu planów testów.

    Niektóre pull requesty wysyłane do głównego repozytorium mogą nie zawierać odpowiedniego planu testów. Pomagają one recenzentom zrozumieć, jak zmiana została przetestowana, i mogą skrócić czas potrzebny na akceptację wkładu.

Każde z tych działań ma duży wpływ, a opiekunowie projektu będą niezwykle wdzięczni za Twoją pomoc.

Nasz proces rozwojowy​

Używamy zgłoszeń i pull requestów na GitHubie do śledzenia zgłoszeń błędów i wkładów społeczności. Wszystkie zmiany od inżynierów Meta są synchronizowane z GitHubem przez most z wewnętrznym systemem kontroli wersji Meta. Zmiany od społeczności są obsługiwane przez pull requesty na GitHubie.

Po zatwierdzeniu zmiany wprowadzonej na GitHubie, jest ona najpierw importowana do wewnętrznego systemu kontroli wersji Facebooka i testowana z kodem Facebooka. Po scaleniu w Facebooku zmiana ostatecznie wróci na GitHub jako pojedynczy commit po przejściu wewnętrznych testów Facebooka.

Więcej o procesie współtworzenia dowiesz się z następujących dokumentów:

Mamy także prężną społeczność współtwórców, którzy chętnie pomogą Ci rozpocząć przygodę. Możesz skontaktować się z zespołem React Native przez @ReactNative.

Repozytoria​

Główne repozytorium zawiera sam framework React Native - tam śledzimy zgłoszenia błędów i zarządzamy pull requestami.

Oto kilka innych repozytoriów, z którymi warto się zapoznać:

Przeglądając te repozytoria, zyskasz wgląd w sposób zarządzania projektem open source React Native.

Zgłoszenia na GitHubie​

Używamy GitHub Issues wyłącznie do śledzenia błędów. Procesy obsługi zgłoszeń opisaliśmy na Stronie Triage'owania Zgłoszeń.

Błędy bezpieczeństwa​

Meta prowadzi program nagród za bezpieczne zgłaszanie luk w zabezpieczeniach. W takich przypadkach postępuj zgodnie z procedurą opisaną na tej stronie i nie zgłaszaj problemu publicznie.

Pomoc w dokumentacji​

Dokumentacja React Native hostowana jest w repozytorium strony React Native. Strona zbudowana jest przy użyciu Docusaurus. Jeśli chcesz wprowadzić zmiany w dokumentacji, kliknij przycisk "Edytuj" w prawym górnym rogu większości stron.

Jeśli dodajesz nową funkcjonalność lub wprowadzasz zmianę w zachowaniu, poprosimy Cię o aktualizację dokumentacji.

Współtworzenie bloga​

Blog React Native generowany jest ze źródeł Markdown.

Przed napisaniem artykułu na bloga React Native, zgłoś pomysł w repozytorium strony lub oznacz nas na @ReactNative w serwisie Twitter i uzyskaj zgodę maintainera. W większości przypadków lepiej opublikować artykuł na własnym blogu lub medium. Warto jednak zapytać - być może Twój materiał idealnie pasuje do naszego bloga.

Więcej o współtworzeniu strony dowiesz się z pliku Readme repozytorium react-native-website.

Współtworzenie kodu​

Wkład w kod React Native odbywa się głównie poprzez pull requesty. Wymaga to sforkowania repozytorium i wprowadzenia zmian lokalnie.

Przewodnik krok po kroku​

Gdy będziesz gotowy do współtworzenia kodu, zajrzyj do naszego przewodnika po wysyłaniu pierwszego pull requesta lub przeczytaj Jak współtworzyć kod dla szczegółowych informacji.

Testy​

Testy pomagają nam zapobiegać wprowadzaniu regresji do kodu źródłowego. Repozytorium GitHub jest stale testowane przy użyciu CircleCI, a wyniki są dostępne poprzez funkcję Checks w commits i pull requestach.

Więcej o uruchamianiu i pisaniu testów dowiesz się na stronie Jak uruchamiać i pisać testy.

Wkład społeczności​

Wkład w React Native nie ogranicza się do GitHub. Możesz pomagać innym, dzieląc się swoimi doświadczeniami z używania React Native - czy to poprzez posty na blogach, prezentacje na konferencjach, czy po prostu dzielenie się przemyśleniami na Twitterze z tagiem @ReactNative.