Przejdź do głównej zawartości

Prześlij opinię

Twoja opinia i wkład pomagają kształtować przyszłość programowania wspomaganego AI. Dowiedz się, jak zgłaszać problemy, sugerować funkcje, wnosić wkład w kod i pomagać w ulepszaniu dokumentacji.

  1. Przeszukaj istniejące problemy aby uniknąć duplikatów

  2. Zweryfikuj problem czy jest powtarzalny

    • Spróbuj w czystym środowisku
    • Wyłącz rozszerzenia/wtyczki
    • Zaktualizuj do najnowszej wersji
  3. Zbierz informacje

    • Komunikaty błędów (pełny tekst)
    • Kroki do odtworzenia
    • Informacje o systemie
    • Zrzuty ekranu/nagrania jeśli stosowne
## Opis błędu
[Jasny, zwięzły opis problemu]
## Kroki do odtworzenia
1. [Pierwszy krok]
2. [Drugi krok]
3. [Zobacz błąd]
## Oczekiwane zachowanie
[Co powinno się stać]
## Rzeczywiste zachowanie
[Co faktycznie się dzieje]
## Środowisko
- Narzędzie: [Cursor/Claude Code]
- Wersja: [np. 1.2.4]
- OS: [np. macOS 14.5]
- Inne: [istotne szczegóły]
## Dodatkowy kontekst
[Zrzuty ekranu, logi, powiązane problemy]

RÓB:

  • Wyjaśnij problem, który próbujesz rozwiązać
  • Podaj konkretne przypadki użycia
  • Zasugeruj podejścia implementacji
  • Linkuj do podobnych funkcji w innych narzędziach
  • Najpierw sprawdź zainteresowanie społeczności

NIE RÓB:

  • Żądaj natychmiastowej implementacji
  • Duplikuj istniejące prośby
  • Łącz wiele funkcji w jedną prośbę
  • Zakładaj, że Twój przepływ pracy jest uniwersalny
## Opis funkcji
[Co chcesz dodać/zmienić]
## Opis problemu
[Jaki problem to rozwiązuje?]
## Przypadki użycia
1. [Konkretny scenariusz 1]
2. [Konkretny scenariusz 2]
## Proponowane rozwiązanie
[Jak to mogłoby działać?]
## Rozważane alternatywy
[Inne sposoby rozwiązania tego]
## Dodatkowy kontekst
[Makiety, przykłady, referencje]
  1. Oficjalne kanały

  2. Głosowanie społeczności

    • Głosuj na istniejące prośby
    • Komentuj z dodatkowymi przypadkami użycia
    • Dziel się w mediach społecznościowych dla wsparcia

Napraw błędy i literówki

  • Popraw pisownię/gramatykę
  • Napraw zepsute linki
  • Zaktualizuj nieaktualne informacje
  • Wyjaśnij mylące sekcje

Dodaj przykłady

  • Rzeczywiste przypadki użycia
  • Fragmenty kodu
  • Zrzuty ekranu/GIF-y
  • Samouczki wideo

Przetłumacz treść

  • Tłumacz na nowe języki
  • Przejrzyj istniejące tłumaczenia
  • Lokalizuj przykłady
  • Adaptacje kulturowe

Twórz samouczki

  • Przewodniki krok po kroku
  • Najlepsze praktyki
  • Przykłady przepływów pracy
  • Wskazówki i triki
  1. Zrób fork repozytorium

    Okno terminala
    git clone https://github.com/[repo]/[projekt]
    cd [projekt]
  2. Utwórz gałąź

    Okno terminala
    git checkout -b docs/improve-setup-guide
  3. Wprowadź zmiany

    • Przestrzegaj przewodnika stylu
    • Przetestuj wszystkie przykłady
    • Podgląd lokalnie
  4. Prześlij pull request

    • Jasny opis
    • Referencje do problemów
    • Zrzuty ekranu jeśli zmiany UI

Styl pisania:

  • Jasny i zwięzły
  • Strona czynna
  • Czas teraźniejszy
  • Druga osoba (“ty”)

Styl techniczny:

  • Używaj bloków kodu z podświetlaniem składni
  • Dołącz ścieżki plików i numery linii
  • Testuj wszystkie przykłady kodu
  • Podaj przykłady proste i zaawansowane
  1. Przeczytaj wytyczne współtworzenia

    • Sprawdź CONTRIBUTING.md
    • Przejrzyj przewodnik stylu kodu
    • Zrozum strukturę projektu
  2. Zacznij od małego

    • Napraw błąd
    • Ulepsz testy
    • Ulepsz dokumentację
    • Potem zajmij się funkcjami
  3. Najpierw komunikuj się

    • Omów duże zmiany
    • Uzyskaj opinię na temat podejścia
    • Koordynuj z opiekunami

Lista kontrolna dobrego PR:

  • Opisowy tytuł
  • Jasne wyjaśnienie problemu/rozwiązania
  • Dołączone testy
  • Zaktualizowana dokumentacja
  • Zgodność ze stylem kodu
  • Przejście kontroli CI/CD
  • Adresowanie opinii z przeglądu

Przykład szablonu PR:

## Opis
[Co robi ten PR?]
## Typ zmiany
- [ ] Naprawa błędu
- [ ] Nowa funkcja
- [ ] Zmiana przełomowa
- [ ] Dokumentacja
## Testowanie
[Jak to zostało przetestowane?]
## Lista kontrolna
- [ ] Testy przechodzą
- [ ] Dokumentacja zaktualizowana
- [ ] Kod zgodny z przewodnikiem stylu

Fora opinii:

  • Historie sukcesu
  • Ulepszenia przepływu pracy
  • Punkty bólu
  • Odkrycia funkcji

Kanały:

  • Fora społeczności
  • Media społecznościowe (#CursorIDE #ClaudeCode)
  • Posty na blogach
  • Wystąpienia konferencyjne

Uczestnictwo w:

  • Kwartalne ankiety użytkowników
  • Głosowania priorytetów funkcji
  • Badania użyteczności
  • Programy testów beta

Dziel się szczegółowymi doświadczeniami:

  1. Przegląd projektu: Co zbudowałeś
  2. Wyzwania: Napotkane problemy
  3. Rozwiązania: Jak AI pomogło
  4. Wyniki: Osiągnięte rezultaty
  5. Lekcje: Czego się nauczyłeś

Beta Cursor

Ustawienia → Aktualizacja → Kanał beta

  • Wczesny dostęp do funkcji
  • Bezpośredni kanał opinii
  • Wpływ na rozwój

Beta Claude Code

Okno terminala
npm install -g @anthropic-ai/claude-code@beta
  • Testuj nowe możliwości
  • Zgłaszaj problemy specyficzne dla beta
  1. Testuj dokładnie: Używaj w prawdziwych projektach
  2. Zgłaszaj problemy: Z szczegółowymi krokami odtworzenia
  3. Podawaj opinię: Zarówno pozytywną, jak i negatywną
  4. Bądź zaangażowany: Uczestnictwo w dyskusjach
  5. Bądź cierpliwy: Spodziewaj się błędów i zmian

Ten przewodnik sam jest otwarty na wkład:

  1. Zrób fork repozytorium

    Okno terminala
    git clone https://github.com/[twoja-nazwa-użytkownika]/developer-toolkit
  2. Wprowadź ulepszenia

    • Napraw błędy
    • Dodaj przykłady
    • Ulepsz wyjaśnienia
    • Zaktualizuj dla nowych funkcji
  3. Prześlij zmiany

    • Utwórz pull request
    • Wyjaśnij ulepszenia
    • Linkuj do źródeł

Obecne priorytety:

  • Więcej przykładów z prawdziwego świata
  • Skrypty samouczków wideo
  • Tłumaczenia
  • Zaawansowane przypadki użycia
  • Scenariusze rozwiązywania problemów

Aktywni współtwórcy otrzymują:

  • Odznaki współtwórcy na forach
  • Uznanie w notatkach wydania
  • Wczesny dostęp do funkcji
  • Bezpośrednią komunikację z zespołami
  • Bilety konferencyjne (najlepsi współtwórcy)

Twój wkład jest na stałe zapisany:

  • Historia Git
  • Strona współtwórców
  • Notatki wydania
  • Raporty roczne

Bądź szanujący:

  • Krytykuj pomysły, nie ludzi
  • Zakładaj dobre intencje
  • Uznawaj obecne ograniczenia
  • Sugeruj ulepszenia

Bądź konkretny:

  • Podaj konkretne przykłady
  • Wyjaśnij wpływ
  • Zasugeruj rozwiązania
  • Dołącz kontekst

Bądź profesjonalny:

  • Używaj odpowiedniego języka
  • Trzymaj się tematu
  • Unikaj gorących debat
  • Skup się na ulepszeniach

Cursor:

Claude Code:

  • Krytyczne błędy: 24-48 godzin
  • Prośby o funkcje: Przegląd miesięczny
  • Dokumentacja: 1-2 tygodnie
  • Ogólna opinia: Najlepsze starania

Dziękujemy za pomoc w uczynieniu programowania wspomaganego AI lepszym dla wszystkich!