Bu məqalədə Pull Request-in (PR) nə olduğunu, dəyişiklikləri müzakirə etmək üçün niyə istifadə edildiyini öyrənəcək, PR-ləri birbaşa IDE-dən yaratmağı və nəzərdən keçirməyi bacaracaqsınız. Üstəlik, yaxşı commit üçün üç qaydaya da baxacağıq. Bu əsas biliklər vacibdir: Claude Code sizin üçün pull request hazırlayıb şərh yaza bilər, amma bundan şüurlu istifadə etmək üçün PR-in nə olduğunu və nə üçün lazım gəldiyini anlamaq gərəkdir.
Nümunələr və interfeys şəkilləri JetBrains IDE-sinə aiddir; əməliyyatların adları və yeri sizin versiyanızda fərqli ola bilər. Məşqlər üçün ayrıca təlim repozitoriyasından istifadə edin. İş layihəsində isə onun budaqlar, dəyişikliklərin qeydə alınması və göndərilməsi ilə bağlı qaydalarına əməl edin.
Pull request-lər nə üçün lazımdır
Komandada dəyişiklikləri ümumi budağa daxil etməzdən əvvəl müzakirə etmək faydalıdır. Pull request təklif olunan diff-i, qeydləri və yoxlamaların nəticələrini bir yerdə toplayır. Öz işini birləşdirməzdən əvvəl nəzərdən keçirmək istəyənlər şəxsi layihələrdə də PR-dən istifadə edirlər.
PR prosesində əvvəlcə birləşdirmə təklifi yaradırsınız. GitHub-da buna Pull Request, bəzi başqa platformalarda isə Merge Request deyilir. Konkret iş qaydasını komanda müəyyənləşdirir.
Pull Request rəsmi xahişdir: "zəhmət olmasa, mənim budağımdakı dəyişiklikləri götürüb (pull) əsas budağa əlavə edin (merge)". Amma bu, sadəcə xahiş deyil. Kod main-ə düşməzdən əvvəl onu müzakirə etmək, yoxlamaq və yaxşılaşdırmaq üçün bütöv bir məkandır.
Claude Code PR üçün başlıq, təsvir və rəy hazırlaya bilər, məsələn, GitHub CLI vasitəsilə. Əvvəlcə qaralamanı yoxlayın. PR yaratmaq və ya şərh göndərmək GitHub-a məlumat yazmaq deməkdir; bunu yalnız sizin tapşırığınızla edir.
Pull request üçün standart iş prosesi
Yeni funksionallıq hazırlayarkən tipik prosesin necə göründüyünə addım-addım baxaq.
Budaq yaratmazdan əvvəl hansı budaqdan başladığınızı və onun commit-lərinin GitHub-dakı hədəf budaqla fərqini yoxlayın. Yeni PR-ə əlaqəsiz lokal commit-lər düşməməlidir. "Sinxronlaşdırmaq" xatirinə onları avtomatik göndərməyin: tapşırıq üçün düzgün bazanı seçin və əvvəlki işi ayrıca saxlayın.
Addım 1. Yeni tapşırıq üçün budaq yaradın. Burada göstərilən PR prosesində iş ayrıca budaqda başlayır. Tutaq ki, contributor-lar üçün qaydaların olduğu fayl əlavə etmək istəyirik - feature/add-contribution-guide budağını yaradaq.
Addım 2. Dəyişiklikləri edin və budağı GitHub-a göndərin. Yeni budaqda CONTRIBUTING.md faylı yaradın (yaratdıqdan sonra Add düyməsini basın) və orada digər tərtibatçılar üçün mesaj yazın. Sonra aydın mesajla Commit and Push edin, məsələn, docs: Add contribution guide.
Bu, əsas addımdır. Pull Request uzaq serverdə artıq mövcud olan budaq əsasında yaradılır. Buna görə PR yaratmazdan əvvəl yeni budağı mütləq GitHub-a göndərmək (push) lazımdır.
IDE-dən Pull Request yaratmaq
Müqayisənin hər iki tərəfini yoxlayın: base dəyişikliklərin təklif olunduğu budaqdır, compare/head isə işinizin olduğu budaqdır. PR yaratmazdan əvvəl commit siyahısına və diff-ə baxın.
Budağınız artıq GitHub-dadır, indi Pull Request yarada bilərsiniz.
Addım 1. Pull Requests vərəqəsini açın. IDE-nin sol yan panelində Pull Requests vərəqəsini tapın. Açıb + işarəsinə (və ya Create Pull Request düyməsinə) klikləyin.
Addım 2. PR məlumatlarını doldurun. IDE rahat forma açacaq. Onu düzgün doldurmaq lazımdır. Əsas sahələr bunlardır:
- başlıq - IDE çox vaxt buraya budağın adını və ya son commit-in mətnini əlavə edir; başlığın qısa, anlaşılan və dəyişikliklərin mahiyyətini əks etdirdiyinə əmin olun;
- təsvir - həmkarlarınıza konkret olaraq nə etdiyinizi və nə üçün etdiyinizi ətraflı izah edin;
- rəyçilər (Reviewers) - dəyişiklikləri yoxlamağı xahiş etdiyiniz şəxslər. Təsdiqin məcburi olub-olmadığını repozitoriyanın qaydaları müəyyən edir;
- icraçılar (Assignees) - adətən burada özünüzü müəllif və rəydən sonrakı düzəlişlərə cavabdeh şəxs kimi göstərirsiniz.
Create Pull Request düyməsini basmazdan əvvəl base, head və diff-i bir daha yoxlayın. İş rəyə hazır deyilsə, bu seçim mövcud olduqda Draft PR yarada bilərsiniz. Həm adi PR, həm də draft repozitoriyaya girişi olan şəxslərə görünür.
Code review - yoxlama və müzakirə
PR yaradılandan sonra ən vacib mərhələ - code review başlayır. Həmkarlarınız PR-i aça, bütün dəyişikliklərə baxa və şərhlər yaza bilərlər.
Bütün müzakirələr IDE-də, Pull Requests vərəqəsində görünür. Kimsə kod sətrinə şərh yazsa, bildiriş alacaqsınız və brauzerə keçmədən cavab verə biləcəksiniz.
Dəyişiklik etməyiniz istənilsə, nə etməli? Çox sadədir: yeni PR yaratmağa ehtiyac yoxdur. Bu PR-in mənbə budağındakı kodu dəyişin, yeni commit yaradıb göndərin. GitHub-dakı Pull Request avtomatik yenilənəcək və yeni commit-lər mövcud müzakirəyə əlavə olunacaq.
Claude Code code review-da iştirak edə bilər: PR-dəki dəyişikliklərə baxıb şərhlər yaza bilər. Bu, ilk baxış üçün əlverişlidir, amma yekun qərar və koda görə məsuliyyət sizdə və komandada qalır.
İşin tamamlanması - budağın birləşdirilməsi və silinməsi
Bütün qeydlər düzəldiləndə və komanda dəyişiklikləri təsdiqləyəndə (approval alanda) Pull Request-i birləşdirmək olar. Adətən bunu baş tərtibatçı edir, amma repozitoriyada müvafiq hüququnuz varsa, özünüz də edə bilərsiniz.
Addım 1. Birləşdirmə. Qeydləri, tələb olunan təsdiqləri və yoxlamaların statuslarını nəzərdən keçirin. Qaydalar və hüquqlar birləşdirməyə icazə verirsə, layihənin qaydalarına uyğun mövcud üsullardan birini (merge, squash və ya rebase) seçib təsdiqləyin. Dəyişikliklər PR-in hədəf budağına, bizim nümunədə isə main-ə düşəcək.
Addım 2. Budağın silinməsi. Birləşdirmədən sonra feature budağı artıq lazım deyil. Repozitoriyanı lazımsız budaqlarla doldurmamaq üçün onu silmək yaxşıdır. GitHub Delete branch düyməsi ilə bunu təklif edəcək.
Birləşdirmədən sonra lokal olaraq main-ə keçin, yeniləmələri götürün və PR-in nəticəsinin orada olduğuna əmin olun. Sonra tapşırığın lokal budağında lazımlı iş qalmayıbsa, onu silə bilərsiniz. IDE adi qaydada silməyə icazə vermirsə, əvvəlcə səbəbini araşdırın, xüsusən də squash və ya rebase-dən sonra.
Yaxşı commit üçün üç qayda
Yaxşı commit yalnız düzgün mesaj deyil, həm də düzgün məzmundur. Dəyişiklik tarixçəsini aydın və faydalı saxlamaq üçün üç sadə qaydaya əməl edin.
Qayda 1 - aydın commit mesajları yazın
Commit-ləriniz komandaya və gələcəkdə özünüzə ünvanlanan mesajlardır. Tarixçə yalnız "fix" və ya "update" mesajlarından ibarətdirsə, onun faydası yoxdur. Geniş yayılmış formatlardan biri Conventional Commits-dir. Bu format belə bir quruluş təklif edir:
<növ>: <qısa təsvir>
Növ dəyişiklik kateqoriyasını təsvir edən qısa sözdür:
feat- yeni funksionallıq;fix- xətanın düzəldilməsi;docs- sənədləşmədə dəyişikliklər;style- məntiqə təsir etməyən formatlama düzəlişləri;refactor- yeni funksionallıq əlavə etməyən və xətaları düzəltməyən kod dəyişiklikləri;test- testlərin əlavə edilməsi və ya düzəldilməsi;chore- rutin işlər (asılılıqların yenilənməsi, build-in sazlanması).
Nümunələr:
- Pis:
fixed bug - Yaxşı:
fix: Correct user login validation - Pis:
readme - Yaxşı:
docs: Update installation instructions
Claude Code-dan repozitoriyada qəbul olunmuş mesaj formatından istifadə etməsini xahiş edin. Komanda başqa qayda seçibsə, Conventional Commits məcburi deyil.
Qayda 2 - bir commit, bir məntiqli dəyişiklik
Bir commit-ə bug düzəlişini, yeni funksiyanı və köhnə kodun refactor-unu sığışdırmağa çalışmayın. Belə commit-i rəydə yoxlamaq çətindir, onu zərərsiz şəkildə ləğv etmək isə demək olar ki, mümkün deyil. Hər commit konkret bir işi həll etməlidir.
- Pis: avatar sahəsi əlavə edən, adın yoxlanmasını düzəldən və düymələrin rəngini dəyişən bir "Update user page" commit-i;
- Yaxşı: üç ayrı commit:
feat: Add avatar upload to user profilefix: Correct username validation logicfeat: Update button colors on user page
İşin gedişində bir faylda həddindən artıq dəyişiklik etmisinizsə, IDE bütün faylı deyil, yalnız bir hissəsini commit etməyə imkan verir: Commit pəncərəsində faylı açıb yalnız konkret tapşırığa aid fraqmentlərin (chunks) yanına işarə qoya bilərsiniz.
Qayda 3 - dəyişikliklərin nəticəsini yoxlayın
Birləşdirmədən əvvəl dəyişikliyə uyğun yoxlamaları yerinə yetirin və faktiki nəticələrə baxın. Sənədləşmədə düzəlişlə yeni məntiq üçün yoxlama dəsti fərqli olacaq.
Əgər repozitoriyada avtomatik yoxlamalar artıq sazlanıbsa, PR onların statusunu göstərir. Yaşıl işarə yalnız işə salınmış konkret yoxlamaların uğurlu olduğunu bildirir, xətaların olmadığını sübut etmir. Hansı yoxlamaların işlədiyini və nəyin yoxlanmadığını nəzərdən keçirin. Avtomatlaşdırmanın sazlanması ayrıca mövzudur.
Claude Code ilə birlikdə necə işləyir
PR Claude Code-un xüsusilə faydalı olduğu mərhələdir. Bunlara diqqət edin:
- Claude budağınızdan hazır başlıq və təsvirlə pull request yarada bilər - PR GitHub-da yaradılmamışdan əvvəl mətni yoxlayın;
- PR-dəki dəyişikliklərə nəzər salıb ilk baxış kimi şərhlər yaza bilər;
- layihənin qaydalarına uyğun commit mesajları hazırlamağa kömək edir;
- artıq sazlanmış yoxlamaların nəticələrini oxumağa və yoxlanmamış məqamları göstərməyə kömək edə bilər.
PR kodun main-ə düşməzdən əvvəl yoxlanması üçündür. Təsviri və rəyin bir hissəsini Claude Code hazırlasa belə, yekun təsdiq və birləşdirməyə görə məsuliyyət insanda qalır. Merge düyməsini basmazdan əvvəl nəyin birləşdirildiyini oxuyun.
Əvvəlki məqalə: Git-də budaqlar və birləşdirmə · Növbəti məqalə: Git-də dəyişikliklərin ləğvi və bərpası
GO TO FULL VERSION