Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
141 lines (92 loc) · 6.63 KB

CONTRIBUTING.md

File metadata and controls

141 lines (92 loc) · 6.63 KB
Raw

Wkład w Zoo Code

Zoo 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”, co oznacza, że wszystkie żądania ściągnięcia (PR) 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

1. Kodeks postępowania

Wszyscy współtwórcy muszą przestrzegać naszego Kodeksu postępowania.

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 dla 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 Zoo Code

  • Discord: Dołącz do naszego Discorda.
  • Reddit: Dołącz do naszego Reddita.

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 na GitHubie.
  • 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 głównego zespołu na Discordzie, aby zostać przypisanym. Przypisanie zostanie potwierdzone w wątku.
  • PR-y muszą być połączone ze zgłoszeniem. Niepołączone PR-y mogą zostać zamknięte.

Decydowanie, nad czym pracować

Zgłaszanie błędów

  • Najpierw sprawdź istniejące raporty.
  • Utwórz nowy błąd, używając szablonu „Zgłoszenie błędu” z:
    • Jasnymi, ponumerowanymi krokami reprodukcji
    • Oczekiwanym a rzeczywistym wynikiem
    • Wersją Zoo 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.

Proces rozwoju i przesyłania

Konfiguracja środowiska programistycznego

  1. Sforkuj i sklonuj:
git clone https://github.com/YOUR_USERNAME/Zoo-Code.git
  1. Zainstaluj zależności:
pnpm install
  1. 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 głównego zespołu na Discordzie. 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ą Zoo Code.