[English](../../CONTRIBUTING.md) • [Català](../ca/CONTRIBUTING.md) • [Deutsch](../de/CONTRIBUTING.md) • [Español](../es/CONTRIBUTING.md) • [Français](../fr/CONTRIBUTING.md) • [हिंदी](../hi/CONTRIBUTING.md) • [Bahasa Indonesia](../id/CONTRIBUTING.md) • [Italiano](../it/CONTRIBUTING.md) • [日本語](../ja/CONTRIBUTING.md) [한국어](../ko/CONTRIBUTING.md) • [Nederlands](../nl/CONTRIBUTING.md) • Polski • [Português (BR)](../pt-BR/CONTRIBUTING.md) • [Русский](../ru/CONTRIBUTING.md) • [Türkçe](../tr/CONTRIBUTING.md) • [Tiếng Việt](../vi/CONTRIBUTING.md) • [简体中文](../zh-CN/CONTRIBUTING.md) • [繁體中文](../zh-TW/CONTRIBUTING.md)
# Wkład w Roo Code Roo Code to projekt społecznościowy i głęboko cenimy każdy wkład. Aby usprawnić współpracę, działamy w oparciu o [podejście „najpierw zgłoszenie”](#podejście-najpierw-zgłoszenie), co oznacza, że wszystkie [żądania ściągnięcia (PR)](#przesyłanie-żądania-ściągnięcia) muszą być najpierw połączone ze zgłoszeniem na GitHubie. Prosimy o uważne zapoznanie się z tym przewodnikiem. ## Spis treści - [Zanim zaczniesz wnosić wkład](#zanim-zaczniesz-wnosić-wkład) - [Znajdowanie i planowanie swojego wkładu](#znajdowanie-i-planowanie-swojego-wkładu) - [Proces rozwoju i przesyłania](#proces-rozwoju-i-przesyłania) - [Kwestie prawne](#kwestie-prawne) ## Zanim zaczniesz wnosić wkład ### 1. Kodeks postępowania Wszyscy współtwórcy muszą przestrzegać naszego [Kodeksu postępowania](./CODE_OF_CONDUCT.md). ### 2. Mapa drogowa projektu Nasza mapa drogowa wyznacza kierunek projektu. Dostosuj swój wkład do tych kluczowych celów: ### Niezawodność na pierwszym miejscu - Zapewnij, że edycja różnic i wykonywanie poleceń są niezawodne. - Zmniejsz punkty tarcia, które zniechęcają do regularnego użytkowania. - Zagwarantuj płynne działanie we wszystkich lokalizacjach i na wszystkich platformach. - Rozszerz solidne wsparcie для szerokiej gamy dostawców i modeli sztucznej inteligencji. ### Ulepszone wrażenia użytkownika - Usprawnij interfejs użytkownika/doświadczenie użytkownika dla jasności i intuicyjności. - Ciągle ulepszaj przepływ pracy, aby sprostać wysokim oczekiwaniom, jakie programiści mają wobec narzędzi codziennego użytku. ### Lider w wydajności agentów - Ustanów kompleksowe wzorce oceny (ewaluacje) w celu pomiaru rzeczywistej produktywności. - Ułatw wszystkim łatwe uruchamianie i interpretowanie tych ewaluacji. - Dostarczaj ulepszenia, które wykazują wyraźny wzrost wyników ewaluacji. Wspomnij o dostosowaniu do tych obszarów w swoich PR-ach. ### 3. Dołącz do społeczności Roo Code - **Głównie:** Dołącz do naszego [Discorda](https://discord.gg/roocode) i wyślij wiadomość prywatną do **Hannes Rudolph (`hrudolph`)**. - **Alternatywa:** Doświadczeni współtwórcy mogą angażować się bezpośrednio za pośrednictwem [projektów na GitHubie](https://github.com/orgs/RooCodeInc/projects/1). ## Znajdowanie i planowanie swojego wkładu ### Rodzaje wkładu - **Poprawki błędów:** rozwiązywanie problemów z kodem. - **Nowe funkcje:** dodawanie funkcjonalności. - **Dokumentacja:** ulepszanie przewodników i przejrzystości. ### Podejście „najpierw zgłoszenie” Wszystkie wkłady zaczynają się od zgłoszenia na GitHubie przy użyciu naszych uproszczonych szablonów. - **Sprawdź istniejące zgłoszenia**: Przeszukaj [zgłoszenia на GitHubie](https://github.com/RooCodeInc/Roo-Code/issues). - **Utwórz zgłoszenie**, używając: - **Ulepszenia:** szablon „Prośba o ulepszenie” (prosty język skoncentrowany na korzyściach dla użytkownika). - **Błędy:** szablon „Zgłoszenie błędu” (minimalna reprodukcja + oczekiwane a rzeczywiste + wersja). - **Chcesz nad tym popracować?** Skomentuj „Zgłaszam się” w zgłoszeniu i wyślij wiadomość prywatną do **Hannes Rudolph (`hrudolph`)** na [Discordzie](https://discord.gg/roocode), aby zostać przypisanym. Przypisanie zostanie potwierdzone w wątku. - **PR-y muszą być połączone зі zgłoszeniem.** Niepołączone PR-y mogą zostać zamknięte. ### Decydowanie, nad czym pracować - Sprawdź [projekt na GitHubie](https://github.com/orgs/RooCodeInc/projects/1) pod kątem zgłoszeń „Zgłoszenie [Nieprzypisane]”. - Aby uzyskać dokumentację, odwiedź [dokumentację Roo Code](https://github.com/RooCodeInc/Roo-Code-Docs). ### Zgłaszanie błędów - Najpierw sprawdź istniejące raporty. - Utwórz nowy błąd, używając szablonu [„Zgłoszenie błędu”](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) z: - Jasnymi, ponumerowanymi krokami reprodukcji - Oczekiwanym a rzeczywistym wynikiem - Wersją Roo Code (wymagane); dostawcą/modelem sztucznej inteligencji, jeśli ma to zastosowanie - **Problemy z bezpieczeństwem**: Zgłoś je prywatnie za pośrednictwem [zaleceń dotyczących bezpieczeństwa](https://github.com/RooCodeInc/Roo-Code/security/advisories/new). ## Proces rozwoju i przesyłania ### Konfiguracja środowiska programistycznego 1. **Sforkuj i sklonuj:** ``` git clone https://github.com/TWOJA_NAZWA_UŻYTKOWNIKA/Roo-Code.git ``` 2. **Zainstaluj zależności:** ``` pnpm install ``` 3. **Debugowanie:** Otwórz za pomocą VS Code (`F5`). ### Wytyczne dotyczące pisania kodu - Jeden skoncentrowany PR na funkcję lub poprawkę. - Przestrzegaj najlepszych praktyk ESLint i TypeScript. - Pisz jasne, opisowe commity odwołujące się do zgłoszeń (np. `Naprawia #123`). - Zapewnij dokładne testy (`npm test`). - Zrób rebase na najnowszą gałąź `main` przed przesłaniem. ### Przesyłanie żądania ściągnięcia - Zacznij jako **wersja robocza PR**, jeśli szukasz wczesnej opinii. - Jasno opisz swoje zmiany, postępując zgodnie z szablonem żądania ściągnięcia. - Połącz zgłoszenie w opisie/tytule PR (np. „Naprawia #123”). - Udostępnij zrzuty ekranu/filmy wideo dotyczące zmian w interfejsie użytkownika. - Wskaż, czy konieczne są aktualizacje dokumentacji. ### Polityka dotycząca żądań ściągnięcia - Musi odnosić się do przypisanego zgłoszenia na GitHubie. Aby zostać przypisanym: skomentuj „Zgłaszam się” w zgłoszeniu i wyślij wiadomość prywatną do **Hannes Rudolph (`hrudolph`)** na [Discordzie](https://discord.gg/roocode). Przypisanie zostanie potwierdzone w wątku. - Niepołączone PR-y mogą zostać zamknięte. - PR-y muszą przejść testy CI, być zgodne z mapą drogową i mieć przejrzystą dokumentację. ### Proces przeglądu - **Codzienna selekcja:** Szybkie sprawdzanie przez opiekunów. - **Cotygodniowy dogłębny przegląd:** Kompleksowa ocena. - **Szybko iteruj** w oparciu o opinie. ## Kwestie prawne Przesyłając wkład, zgadzasz się, że Twoje wkłady będą licencjonowane na podstawie licencji Apache 2.0, zgodnie z licencją Roo Code.