Gerrit/Tutorial/tr

Bu, Git ve Gerrit'in Wikimedia gelişimi için nasıl kullanılacağını açıklayan bir öğreticidir.


 * Zaman kazanmak ve teknoloji meraklısıysanız, bunun yerine çok kısa nasıl yapılır kılavuzunu kullanın:
 * Uzman kullanıcılar için ek belgelere sahiptir.
 * Yalnızca Gerrit ile oynamak ve "gerçek" bir Wikimedia yazılım projesi için bir yama yazmak istemiyorsanız, bunun yerine Gerrit test örneğimizi kullanın.

Bu öğreticide, kutudaki dolar işareti ile başlamak için aşağıdaki gibi komutlar:. önekini girmeyin. Komut ayrıca kendinizi değiştirmeniz gereken bir değişken de içeriyorsa, değişken kırmızı renkte gösterilir:.

Git nedir?
Git ücretsiz ve açık bir kaynaktır dağıtılmış sürüm kontrol sistemi. “Dağıtılmış”, deponun merkezi bir kopyası olmadığı anlamına gelir. Git ile, depoyu klonladıktan sonra, tüm dallar ve etiketli sürümler elinizin altında olacak şekilde kaynak kodunun tam olarak çalışan bir kopyasına sahip olursunuz.

Gerrit nedir?
Gerrit Git ile entegre olan ücretsiz, web tabanlı bir ortak kod inceleme aracıdır.

Temel olarak: Önerilen yazılım değişikliğinizi (Gerrit'te "changeset" olarak adlandırılır) yeni bir dal olarak gönderirsiniz. İlk sürüm ("patchset 1") henüz mükemmel değilse, o dalda ("patchset 2" vb.) daha fazla değişiklik yapabilirsiniz ("amend"). Bir yama seti bir "+2" incelemesi aldığında, kabul edilir ve kod deposunun ana dalında birleştirilir (genellikle "master" olarak adlandırılır). Birleştirme, birisi bu kod deposunu teslim aldığında veya indirdiğinde, yaptığınız değişikliğin varsayılan olarak dahil edileceği anlamına gelir.

Wikimedia geliştirici hesabı oluşturun
Henüz bir Wikimedia geliştirici hesabınız yoksa, wikitech.wikimedia.org sayfasına gidin ve bir hesap oluşturun. Aynı kullanıcı adı ve parola aşağıdaki Gerrit'te oturum açmak için kullanılacaktır.

Git'i kurun
Bu talimatlar Git'in komut satırı (terminal penceresi) aracı olarak nasıl kurulacağını açıklar. Komut satırı yerine grafik kullanıcı arabirimi (GUI) tercih ederseniz, Git projesi tarafından tutulan istemcilerin listesini denetleyin. Alternatif kurulum talimatları için resmi belgelere bakın.

Font Awesome 5 brands linux.svg Linux

 * paketini kurmak için Linux dağıtımınızın grafiksel yazılım paketi yönetim aracını kullanın.
 * Git dağıtımınız tarafından paketlenmemişse, lütfen dağıtımınızın destek forumuna sorun.

Font Awesome 5 brands windows.svg Windows

 * Windows için Git ile https://gitforwindows.org/ üzerinden yükleyin. Bu size Git'e ek olarak bu talimatlardaki komut satırlarının çoğunun Windows üzerinde çalışmasına izin veren "Git Bash" adlı bir kabuk verir.

Apple logo black.svg macOS

 * Homebrew paket yöneticisini kurun ve sonra komutunu çalıştırın – Diğer paketlerin kolay güncellenmesine ve kolayca kurulmasına izin verdiği için bu önerilir.
 * Alternatif olarak, tek başına Git for Mac yükleyebilirsiniz.

Git'i yapılandırın
Git'i yüklediğinize göre artık kişisel bilgilerinizi yapılandırma zamanı. Bunu sadece bir kez yapmanız gerekir. Ayrıca bu komutları tekrar çalıştırarak kişisel bilgilerinizi istediğiniz zaman değiştirebilirsiniz.

Git, kullanıcının adını ve e-postasını kontrol ederek her işlemi yapanları izler. Ayrıca, bu bilgi taahhütlerinizi Gerrit hesabınızla ilişkilendirmek için kullanılır.

Kullanıcı adınızı ve e-posta adresinizi ayarlamak için aşağıdaki iki komutu girin. ile kendi Gerrit kullanıcı adınızla değiştirin ve ile kendi e-posta adresinizle değiştirin:

Gerrit'te SSH Anahtarlarını Ayarla
Bilgisayarınız ve Gerrit arasında güvenli bir bağlantı kurmak için bir SSH anahtarı kullanıyoruz. Wikimedia Güvenlik Ekibi, Ağustos 2021'den itibaren, SSH Anahtarları oluşturan kullanıcıların optimum güvenlik ve performans için  türünü kullanmasını önerir. Yepyeni bir anahtar oluşturmanız gerekip gerekmediğinden emin olmak için, sisteminizde zaten bir SSH anahtarı olup olmadığını kontrol edelim. Bu komutu bir terminalde çalıştırın:

Komut, (gizli)  dizinindeki dosyaları listeler. Dizin sisteminizde zaten varsa ve çıkışta  adlı bir dosya listeleniyorsa, doğrudan #SHH Genel anahtarınızı kopyalayın bölümüne gidebilirsiniz.

Yeni bir SSH anahtarı oluşturun
Yeni bir SSH anahtarı oluşturmak için aşağıdaki komutu girin ve yerine kendi e-posta adresinizi yazın. Varsayılan ayarları istiyoruz, bu nedenle anahtarı kaydetmek için bir dosya girmeniz istendiğinde, enter tuşuna basın.

Güçlü ve benzersiz bir parola girin ve [Enter] tuşuna basın.


 * Parolalar neden önemlidir?


 * Parolalar çok güvenli değildir. Hatırlaması kolay bir tane kullanırsanız, tahmin etmesi veya brute-force daha kolaydır. Rastgele bir tane kullanırsanız, hatırlaması zordur, bu nedenle parolayı not edebilirsiniz. İkisi de çok kötü. Bu nedenle ssh anahtarlarını kullanıyorsunuz. Ancak parola olmadan bir ssh anahtarı kullanmak, temelde bu rastgele parolayı bilgisayarınızdaki bir dosyaya yazmakla aynıdır. Sürücünüze erişim sağlayan herkes, bu anahtarı kullandığınız her sisteme erişim kazanmış olur. Bu yüzden bir parola da eklemelisiniz. Anahtarı her kullanışınızda uzun bir parola girmemek için  adında bir araç vardır. Parolanızı güvenli bir şekilde kaydedebilir. MacOS veya Linux kullanıyorsanız, hayatınızı daha da kolaylaştırmak için anahtarlarınız sistemin anahtar zincirine kaydedilebilir.

komutu  dizininde 2 dosya oluşturacaktır:


 * : özel SSH anahtarınız (tanımlama için)
 * : genel SSH anahtarınız

SSH Genel anahtarınızı kopyalayın
Genel anahtar dosyanızın içeriğini (örneğin, ) panonuza kopyalayın:

Bir seçenek, ortak anahtar dosyanızı en sevdiğiniz metin düzenleyicisiyle (Notepad, TextEdit, gedit vb.) açmaktır. Metin düzenleyicinizin dosya seçici iletişim kutusunda, dosyayı bulmak için “Gizli dosyaları görüntüle”'yi açmanız gerekebilir, çünkü  dizini gizlidir. Bazen "Gizli dosyaları görüntüle" seçeneği, dosya seçici iletişim kutusuna sağ tıklayarak kullanılabilir.

Diğer seçenekler:


 * Linux'ta, çalıştırın ve çıkışı manüel olarak panoya kopyalayın.
 * Windows'ta, Git GUI'yi açabilir, Yardım 🡒 Anahtarı Göster'e gidebilir ve ardından genel anahtarınızı panonuza kopyalamak için "Panoya Kopyala" düğmesine basabilirsiniz.
 * MacOS'ta, genel anahtar dosyanızın içeriğini panonuza kopyalamak için çalıştırabilirsiniz.

SSH Genel anahtarınızı herhangi bir yeni satır veya boşluk eklemeden, aynen yazıldığı gibi kopyalamanız önemlidir. "ssh-ed25519" öneki, anahtarın kendisi ve e-posta adresi son eki dahil olmak üzere tam metni kopyalayın.

Gerrit hesabınıza SSH Genel anahtarı ekleyin

 * Gerrit için web arayüzünde oturum açın. Gerrit'inizin kullanıcı adı ve parolası Wikimedia Geliştirici hesabınız ile aynıdır.
 * Sağ üst köşedeki kullanıcı adınızı tıklayın ve ardından "Ayarlar" seçin.
 * Soldaki menüde "SSH Anahtarları" tıklayın.
 * SSH Genel Anahtarınızı ilgili alana yapıştırın ve "ADD NEW SSH KEY" düğmesine tıklayın.

Git ile kullanmak için SSH Özel anahtarı ekleyin
Git Bash komut satırını başlatın.


 * ssh-agent ile kullanarak çalıştırın
 * Tek tırnak  değil,   vurguyu kullandığınızdan emin olun. (Bu özel karakteri kolayca giremezseniz bu sayfadan kopyalayıp yapıştırabilirsiniz.)
 * Tek tırnak  değil,   vurguyu kullandığınızdan emin olun. (Bu özel karakteri kolayca giremezseniz bu sayfadan kopyalayıp yapıştırabilirsiniz.)


 * Özel anahtarınızı aracıya ekleyin. Yukarıdaki adımları izlediyseniz ve anahtarınızın varsayılan adı  ise, komut şu şekildedir:


 * To permanently add the ssh key, use comand:


 * Her şeyin beklendiği gibi çalışıp çalışmadığını kontrol etmek için  ile Gerrit sunucusuna bağlanın.  ile Gerrit ayarlarınızda gösterilen kullanıcı adınızla değiştirin:

Örnek bir Gerrit SSH bağlantısı başarı mesajı şuna benzer:
 * Dikkatli olun ve "ed25519 anahtar parmak izi" için SSH parmak izi ile aynı olduğunu karşılaştırın. Aynıysa, "Bağlanmaya devam etmek istediğinizden emin misiniz?" sorusuna "Evet" yanıtını verin. Ardından anahtarınızın parolasını girin.
 * "Welcome to Gerrit Code Review" mesajı almalısınız. Son satır "Connection to gerrit.wikimedia.org closed." ifadesini göstermelidir.
 * Sorunla karşılaşırsanız, kullanın ( ile kullanıcı adınızla değiştirin). , sorunların bulunmasına yardımcı olmak için ayrıntılı çıkış sağlayacaktır. Ardından Gerrit Sorun Giderme'yi okuyun.

Git'i kullanarak kod indirin
"Sandbox" adlı deposu indirerek ("cloning" denir) pratik yapalım. Git Bash komut satırı üzerinde aşağıdakileri çalıştırın:

('i Gerrit kullanıcı adınızla değiştirin. Ve URL'nin  ile değil,   ile başladığından emin olun).

Bu işlem, "sandbox" uzantı deposunun tüm geçmişini ve kod tabanını makinenize kopyalar. Uzantının ana dalının (genellikle "git master" olarak da bilinir) bir çalışma dizinine sahip olursunuz. Yeni dizini girin ( komutu ile). Artık koda bakıp düzenlemeye başlayabilirsiniz.

Gerrit ile çalışmaya hazırlanın
Gerrit, kaydetme mesajınızın bir "değişiklik kimliği" içermesini gerektirir I (büyük i) ile başlayan  ile benziyorlar. Gerrit'te mevcut bir yamayı iyileştirmek için bir işlemi değiştirdiğiniz her seferinde, bu değişiklik kimliği aynı kalır, bu nedenle Gerrit bunu aynı kod değişikliğini ele alan yeni bir "yama kümesi" olarak anlar.

Kayıtlarınıza bir Change-ID satırı ekleyen git-review adında bir git taahhüdünüz var. git-review kullanılması önerilir. Git klonunuzu yapılandırmayı, bir değişiklik göndermeyi veya mevcut olanı getirmeyi kolaylaştırır.

git-review yükleme
Wikimedia Gerrit'in git-review 1.27 veya daha yeni bir sürümünü gerektirdiğini unutmayın.

Daha fazla bilgi için lütfen Gerrit/git-review#Kurulum bölümüne bakın.

Font Awesome 5 brands linux.svg Linux

 * paketini kurmak için Linux dağıtımınızın grafiksel yazılım paketi yönetim aracını kullanın.
 * git-review dağıtımınız tarafından paketlenmemişse, git-review'i pip Python paket yükleyicisini kullanarak yüklenmesi gibi diğer seçenekler için git-review kontrol edin.
 * FreeBSD kullanıyorsanız, git-review'i bağlantı noktalarından yükleyin.

Font Awesome 5 brands windows.svg Windows

 * Lütfen git-review Windows sayfasına bakın.

Apple logo black.svg macOS

 * OS X 10.11 El Capitan ve sonrası için, Yöntem 1'i izleyin.
 * 10.11'den önceki sürümlerde, Yöntem 2'yi izleyerek pip Python paket yükleyicisini kullanın.

git-review yapılandırma
Git'in varsayılan uzak ana bilgisayar adı "origin". Bu ad Wikimedia projeleri tarafından da kullanılır. Bu konağı kullanabilmek için git-review söylememiz gerekiyor. yerine Gerrit kullanıcı adınızı yazın:

git-review ayarlama
Bir depoyu indirdikten ("cloning") sonra, git-review için ayarlamanız gerekir. Bu, bir taahhüdü ilk kez göndermeye çalıştığınızda otomatik olarak gerçekleşir, ancak bunu klonlamadan hemen sonra yapmak genellikle daha iyidir. Klonladığınız projenin dizininde olduğunuzdan emin olun (aksi takdirde "hata: Git deposu değil" hatası alırsınız). Ardından şu komutu çalıştırın:

Çıkışının sonuna doğru, şöyle bir şey görmelisiniz:

Bu, kullandığınız kabuk kullanıcı adından farklıysa git kullanıcı adınızı isteyebilir.

Bir yama gönderin
İlgilendiğiniz kod deposunu klonladığınızdan emin olun (buraya bakın).

Kod deposunun dizininde olduğunuzdan emin olun ( komutu size tam olarak nerede olduğunuzu söyler).

Ana geliştirme dalını güncelleyin
Ana geliştirme dalının (depoyu ilk kez klonladığınızda oluşturulan dal) güncel olduğundan emin olun:

Ancak, bazı depoların ana geliştirme dalları için farklı bir ad kullandığını unutmayın (örneğin,  yerine   veya   deposunda   dalı yerine   vardır).

Bir dal oluştur
İlk olarak, yeni değişikliğiniz için yerel bir dal oluşturun. Aşağıdaki kısa ama makul ölçüde açıklayıcı bir adla değiştirin (ör. değişiklikleriniz için karşılık gelen  görev varsa ,   veya  ) Diğer kişiler de dalınızı tanımlamak için bu adı kullanacaktır.

Bu, yeni bir şube oluşturacaktır (en son 'master' üzerinden ) olarak adlandırılır ve sizin için kontrol edin. Yukarıdaki örnekte, bu yeni dalına  adını verdik.

Değişikliklerinizi yapın
Yerel kodunuzda değişiklik yapın. Tercih ettiğiniz metin düzenleyiciyi kullanın ve bir dosyayı değiştirin. Aşağıdaki örnekte,  dosyasını düzenliyoruz ve bir kelime ekliyoruz.

Ardından metin düzenleyicinizi kapatın ve son işlemden bu yana, dosya(lar) ve dizin içinde yaptığınız değişiklikleri kontrol edin:

, değişikliklerinizi birleştirilmiş fark biçimi olarak görüntüler: Kaldırılan satırların bir eksi öneki ve eklenen satırların bir artı  öneki vardır. Bu değişiklikler, bir sonraki kaydetme için henüz "aşamalı" değildir ( üzerinden).

Bir taahhüt için değişikliklerinizi yapın
Yaptığınız değişikliklerden hangisinin taahhüdünüzün bir parçası olacağına karar vermek için çalıştırın. Dizinde değiştirdiğiniz tüm dosyaların bir listesini gösterecektir. Bu noktada, çıkış son satır olarak "kaydetmeye hiçbir değişiklik eklenmedi" ifadesini gösterecektir.

Değiştirdiğiniz dosya(ları)nızı bir sonraki kaydetmenizin parçası haline getirmek için  kullanın. Yukarıdaki örnekte  dosyasını değiştirdik, dolayısıyla komut şöyle olacaktır:

ile geçmediğiniz, değiştirdiğiniz tüm dosyalar, bir sonraki adımda  çalıştırıldığında yok sayılacaktır.

Aşamalı değişikliklerinizi yapın
yoluyla eklenen değişikliklerin listesinden memnun olduğunuzda, bu değişiklikleri kullanarak yerel deponuzdaki bir taahhüde dönüştürebilirsiniz.

Daha sonra metin düzenleyicinizde işleminiz için açıklayıcı bir özet eklemeniz istenecektir. Taahhüt mesajı kurallarına uymalısınız. Kod deposundaki değişikliklerin geçmişine bakarken başkalarının göreceği şey budur.

İşleme mesajını kaydedin ve metin düzenleyicinizi kapatın. Bir özet (tamamlama kimliği, konu satırınız, değiştirilen dosyalar ve satırlar) görüntülenir.

Taahhüdünüzü Gerrit'e aktarmaya hazırlanın
Değişiklik kümenizi, çalışırken ana dalda olabilecek tüm değişikliklerle senkronize edin ("yeniden basma"). Dalınızdan şunları çalıştırın:

Artık kodunuzu incelenmek üzere Gerrit'e göndermeye hazırsınız. Birkaç ilişkili kaydetme yaptıysanız, bunları incelenmek üzere tek bir işlemde birleştirmeyi düşünün.

Taahhüdünüzü Gerrit'e aktarın
Yukarıdaki #Gerrit ile çalışmaya hazırlanın bölümünü takip edip  yüklediyseniz ve   çalıştırdıysanız, değişiklikleri Gerrit'e aktarma komutu:

seçeneği, git-review ile değişikliği Gerrit'e göndermeden önce yeniden gönderme yapmamasını söyler.

Başarılı olduktan sonra, bir onay ve Gerrit'teki değişiklik setine bir bağlantı alacaksınız. Yukarıdaki örnekte, bu bağlantı: https://gerrit.wikimedia.org/r/#/c/sandbox/+/563720

Tebrikler! Yamanız Gerrit'te ve umarım yakında incelenir!

Değişikliği / Sonraki Adımları Görüntüleyin
Gerrit değişiklik setinizin bağlantısını bir web tarayıcısında açın.

"Dosyalar" altında, listedeki herhangi bir dosyanın en sağındaki aşağı oku tıkladıktan sonra, dosya başına yaptığınız değişikliğin farkını görebilirsiniz: Eski satırlar kırmızı renkte ve yeni satırlarınız yeşil renkte gösterilir.

Taahhütünüz Phabricator cinsinden bir bileti ele alırsa, Taahhüt mesajı yönergelerini izlediyseniz, Phabricator görevine otomatik olarak bir yorum eklenir. Bunu yapmadıysanız, tamamlama mesajınızı düzeltebilir (güncellenmiş bir yama seti oluşturarak) veya bu Phabricator biletine Gerrit'teki değişiklik kümenize bir bağlantı içeren bir yorumu manüel olarak ekleyebilirsiniz.

Diğer yaygın durumlar
Ayrıca durumunuz burada ele alınmıyorsa Gerrit Gelişmiş kullanıma bakın.

Rebase ile birkaç taahhüdü tek bir taahhütte toplayın
İncelemeye gönderilmeyi istemeden önce yerel deponuza ilgili birkaç taahhütte bulunduysanız, bu taahhütleri tek bir taahhütte ezmeniz (birleştirmeniz) gerekir.

veya  seçeneği, kaydetme geçmişinizi değiştirmenize (yeniden yazmanıza) olanak tanır. Her taahhüt için, taahhüt mesajını değiştirebilir, dosya ekleyebilir veya kaldırabilir veya başka değişiklikler yapabilirsiniz.

Önce git'i ne kadar geri çekmek istediğinizi söylemelisiniz. Şubenizdeki tüm değişikliklerin bir listesini almak için:

Ayrıca son değişikliklerin görüntülenen listesini de sınırlayabilirsiniz. , son üç taahhüt çek anlamına gelir:

Bu komutu yazdıktan sonra, metin düzenleyiciniz taahhütlerinizi ters sırayla ve kullanılabilir komutların bir listesini görüntüler:

İncelemek için yalnızca bir taahhüt göndermek istediğimizden, son iki taahhüt ilkinde ezeceğiz. Bu nedenle, ilk "pick" ile "squash" olarak değiştirin:

pick aa8cf1d Adding method customFilterFunctionGetRiskyCountryCodeScore to GatewayAdapter. squash 38828e2 Adding $wgDonationInterfaceCustomFiltersFunctionsRiskyCountries to donationinterface.php squash be33007 Fix a typo

Seçip sıkıştırmayı bitirip dosyayı kaydettiğinizde, taahhüt mesajlarınızı düzenlemenize ve birleştirmenize izin vermek için metin düzenleyicinizde başka bir dosya açılır. Change-Id satırlarından yalnızca birini tutmaya ve boş bir satırdan sonra mesajın altında kalmasına dikkat edin.

Önceki taahhütlerinizde gelen mesajlarınız otomatik olarak bu mesaja yerleştirilecektir:

Özet mesajınızı (güncellenmiş) işleme koymayı unutmayın. Bu durumda yeni özet mesaj şöyle olacaktır:

(mingle-fr-2012-69) Adding a custom filter for risky countries.

Her şey yolunda giderse, başarılı bir rebase mesajı görmelisiniz:

Daha sonra yamanızı incelemeye gönderin:

Git incelemenizin Gerrit'e gittiğini gösteren bir mesaj görmelisiniz (bu örnekte https://gerrit.wikimedia.org/r/7187):

Değişikliği düzeltme (kendinizin veya başkasının)
Bazen, gönderilen bir değişikliği değiştirmeniz gerekebilir. Değişiklik henüz birleştirilmediği sürece bir değişikliği değiştirebilirsiniz.

Kendi değişikliklerinizi değiştirebilirsiniz. Başkası tarafından gönderilen değişiklikleri değiştirmek için Gerrit'in Trusted-Contributors grubunun bir üyesi olmanız gerekir. Trusted-Contributors grubun bir üyesi olmak için, üye olan birini bulun ve ondan sizi eklemesini isteyin. Grup, üyelerin yeni üyeler ekleyebilmesi, yetkilerinizi sorumlu bir şekilde kullanabilmesi açısından viraldir.

Yerel dalınızı uzak ile güncel hale getirmek için yeniden temel alın. Yeniden temelleme güncellemelerini ayrı bir yama yapmak en iyisidir, böylece kod inceleyecileri yaptığınız değişiklikleri kolayca görebilir. Gerrit kullandığınızı varsayarsak, bunu Gerrit'in web arayüzünde yamanızı görüntülerken "Rebase Change" düğmesine tıklayarak yapabilirsiniz.

Bu komutla tam sıfırlama ve değişikliği kontrol edin: (DİKKAT:, tüm yerel değişiklikleri kaldıran bir donanım sıfırlaması gerçekleştirir. Önce korumak istediğiniz değişiklikleri saklayın veya uygulayın!)

Örneğin:

Yerel deponuzda bir dalda zaten değişiklik varsa, bunun yerine sadece kontrol edebilirsiniz:

Örneğin:

Ardından, favori metin düzenleyicinizle bazı değişiklikler yapın.

dosyaları gerektiği gibi uygulayın, ardından değişikliği tamamlayın (kaydetmeyi "değiştirdiğinizden" emin olun):

Değişiklikliği push yapın:

burada önemlidir. git-review ile değişikliğinizi ana bilgisayara karşı yeniden düzenlememesini söyler, bu da yama seti 1 ile 2 arasında farklılık gösterir.

Master'dan farklı bir dalına aktarın
Yukarıda taahhüt, ana dalına aktarıldı. Dal adı yalnızca Gerrit kullanıcı arayüzünde işlemin konusu olarak görünüyordu. Eğer gerçekten ana daldan farklı bir şubeye geçmek istiyorsanız,  üzerinden aktarmanız gerekir.

Web arayüzü üzerinden düzenleme
Gerrit'te oturum açtıysanız, doğrudan web arayüzünde kod değişiklikleri de oluşturabilirsiniz. Bu, küçük yamalar yapmak için veya geliştirici olmayanlar için küçük düzeltmelere katkıda bulunmak için yararlı olabilir.


 * 1) https://gerrit.wikimedia.org/r/admin/repos/ gidin ve düzenlemek istediğiniz kod deposunu seçin.
 * 2) Kenar çubuğunda "Commands" seçin
 * 3) "Create Change" tıklayın
 * 4) Dalı "master" olarak ayarlayın (ana dalı kullanmak istemiyorsanız, o proje için mevcut olan diğer dalları kullanabilirsiniz)
 * 5) Konuyu seçtiğiniz bir şeye ayarlayın (ör. "copy-edit" - tümü tek dizeli olmalıdır) (isteğe bağlı)
 * 6) Büyük metin alanına ileti yönergelerini uygulayarak bir açıklama ("taahhüt özeti") yazın. (Örnek)
 * 7) "Create" tıklayın
 * 8) Sağ üst köşede "Edit" düğmesini tıklayın
 * 9) "Files" altında, "ADD/OPEN/UPLOAD" düğmesini tıklayın
 * 10) Düzenlemek istediğiniz dosyanın klasör/dosya yolunu yazın (ör. i18n/en.json) ve "Confirm" düğmesine tıklayın
 * 11) Değiştirmek istediğiniz satırları bulun ve değiştirin.
 * 12) "Save" tıklayın
 * 13) "Close" tıklayın
 * 14) "Publish edit" tıklayın
 * 15) Kod değişikliklerinizden "Work in Progress" durumunu kaldırmak için "Mark as active" seçeneğini tıklayın

Yapıldı!

Mevcut bir değişiklik kümesinin kaydetme mesajını değiştirmeniz gerekirse şu adımları kullanabilirsiniz:


 * 1) Değişiklik setinin kendisine gidin. Örnek URL: https://gerrit.wikimedia.org/r/c/1234567890 (sondaki kimliği değiştirin)
 * 2) "Files" bölümünde "Commit message" düğmesine tıklayın
 * 3) Sağ üst köşede "Edit" düğmesini tıklayın
 * 4) Taahhüt özetinde değişiklik yapın.
 * 5) Sağ üst köşede "Save" düğmesini tıklayın
 * 6) Sağ üst köşede "Close" düğmesini tıklayın
 * 7) Sağ üst köşede "Publish edit" düğmesini tıklayın

Gerrit & Vagrant
MediaWiki-Vagrant is a portable MediaWiki development environment and is readily usable with git-review and gerrit. After installing MediaWiki-Vagrant use  to navigate to your extensions folder. Then follow the instructions above on submitting a patch via gerrit.

Kod Gerrit'te nasıl incelenir
Kod incelemesi katkı iş akışımızın önemli bir parçasıdır. Prensip temeldir: herhangi bir yama birleştirilmeden önce başkaları tarafından incelenmelidir.

Bu, kodunuzun gözden geçirenlere ihtiyaç duyacağı anlamına gelir. Yorum alma tavsiyemize göz atın.

Birleştirmeden önce inceleyin
MediaWiki çekirdeği ve ayrıca herhangi bir uzantı için biz dağıtımı birleştirmeden önce inceleme iş akışına sahip olmak bizim için önemlidir. Bu seçeneği, uzantı için isteyen herhangi bir uzantı yazarına da sunacağız. Tek istisna, incelemeden aktarılabilecek yerelleştirme ve uluslararasılaştırma taahhütleridir.

Kim inceleyebilir? Gerrit proje sahipleri
Geliştirici hesabı oluşturduktan sonra, herkes taahhütler hakkında yorum yapabilir ve eleştirilerini ve onaylarını ifade edebilir. Herkes herhangi bir işleme için bağlayıcı olmayan bir "+1" verebilir. Bununla birlikte, herhangi bir veri deposu ("Gerrit project") için, yalnızca küçük bir grup insan Gerrit içinde kodu onaylama ve arşivde birleştirme yeteneğine sahip olacaktır. Bu süper onay, yanıltıcı bir ad olsa da bir "+2"'dir, çünkü iki +1 onayının toplamı +2 DEĞİLDİR. Bu kişiler "Gerrit proje sahipleri"'dir.

Gerrit'te kod hakkında yorum yapma, inceleme ve birleştirme nasıl yapılır




Gerrit'te kod hakkında herkes yorum yapabilir.

Kodu görüntüleme ve yorum yapma

 * Bir geliştirici hesabı sahibi olduğunuzdan emin olun.
 * Gerrit üzerinden oturum açın. Bakmak istediğiniz değişiklik kümesini biliyorsanız (URL https://gerrit.wikimedia.org/r/#/c/23939/ gibi görünecek), buna gidin. Aksi takdirde, arama kutusunu kullanın. Yazara ("Owner"), Gerrit projesine, dalına, yıldız verdiğiniz değişiklik setlerine vb. göre arama yapabilirsiniz. Gerrit arama belgelendirmesi, kullanabileceğiniz tüm farklı arama iletimlerini kapsar.
 * Değişiklik kümesinde birkaç alan, bağlantı ve düğme bulunur:
 * Vekil. Değişiklik kümesinin incelenmesinden tek bir kişinin sorumlu olmasını sağlayan isteğe bağlı bir alan. Bu, yalnızca vekil kabul etmişse ayarlanmalıdır.
 * İnceleyiciler. 'jenkins-bot', Jenkins testlerinden geçen her şeyi otomatik olarak doğrulayan otomatik inceleyicidir. Yapının geçip geçmediğine bağlı olarak kırmızı veya yeşil bir işaret bildirecektir.
 * "Add reviewer" düğmesi altındaki Reviewers: sol üst köşede birinden manüel olarak inceleme isteyin. Onların Gerrit kontrol panelinde görünecektir.
 * Files altında, Expand All aşağıdaki her dosya için farkı açar. Bir satırı çift tıklayabilir ve ardından o satır hakkında yorum yapmak için C tuşuna basabilir, ardından taslak yorumu kaydetmek için "Save" düğmesine tıklayabilirsiniz. Ardından, yorumunuzu yayınlamak için sayfanın üst kısmındaki "Reply" düğmesini tıklayın.
 * Reply, yorumlarınızı genel bir yorum ve/veya eklediğiniz satır içi yorumlar dahil olmak üzere bir değişiklik grubuna ekler (yukarıya bakın).
 * Kod incelemesi üzerine, approve basarsanız, "Reply" altında "Code-Review: " kullanın; aksi takdirde, reddetmek için "Code-Review:  " kullanın. Bu numaralar bağlayıcı değildir, birleşmelere veya reddedilmelere neden olmaz ve kod incelemesi üzerinde resmi bir etkisi yoktur.
 * Abandon (bu farkı yazdıysan bunu göreceksin). Bu eylem, incelemek üzere listeden farkı kaldırır, ancak arşivleme amacıyla Gerrit'te bırakır.
 * "Only Comments" anahtarı, insan olmayan botların incelemelerini gizlemeye olanak tanır. Örnek için T48148 sayfasına bakın.

Yama kümelerini karşılaştırma
Taahhüdünüzü her değiştirdiğinizde ve incelemeye gönderdiğinizde, yeni bir yama seti oluşturulur. Farklı yama setlerini şu şekilde karşılaştırabilirsiniz:


 * "Files" altında, "Expand All" seçin veya bu dosyayı açmak için listelenen belirli bir dosyayı seçin.
 * Sol tarafta Patch Set altında Base önceden seçilmiştir. Ekranın sağ tarafında Patch Set altında, en son yama seti önceden seçilmiştir. Seçili yama setlerini ihtiyaçlarınıza göre ayarlayın.

Resmi olarak incelemek ve kodu birleştirmek veya reddetmek
Gerrit proje sahiplerinden biriyseniz, şunları da göreceksiniz:


 * Abandon düğmesi
 * * Reply altında, +2 (onayla) veya -2 (veto) için ek Code-Review seçenekleri ve bir Post düğmesi (yorumunuzu yayımlayın ve farkı 1 adımda dalında birleştirin)
 * Submit düğmesi (merge -- yalnızca siz veya bir başkası farka +2 onayı verdiyse, ancak onu birleştirmediyse kullanışlıdır)

Ve bir şeyi örnek Gerrit projesiyle birleştirdiğinizde, onu https://gerrit.wikimedia.org/r/plugins/gitiles/mediawiki/extensions/examples/ olarak göreceksiniz.

Phabricator'da bir göreve kaynaklanan bir taahhüt birleştirdiyseniz ve bu işlemin bu görevi tamamen düzeltmesi gerekiyorsa, lütfen o göreve gidin ve durumunu "Çözüldü" olarak değiştirin (Eylem Ekle… 🡒 Durumu Değiştir açılır menüsünden). Ayrıca gerritbot bu göreve daha önce göndermediyse birleştirme kimliğine bakın.

Sorun giderme
Sorunlar ve nasıl çözüleceği için sayfasına bakın.

Ayrıca bakınız
Ayrıca şu sayfalar da yararlıdır:


 * Gerrit Eğitimi tl;dr
 * Gerrit TortoiseGit eğitimi
 * Wikimedia Gerrit Yama Yükleyicisi
 * Gerrit Eğitimi tl;dr
 * Gerrit TortoiseGit eğitimi
 * Wikimedia Gerrit Yama Yükleyicisi