Gerrit/Eğitim/tl;dr

Bu çok kısa bir (çu;o) Git ve Gerrit'i MediaWiki geliştirmesi için kullanma kılavuzudur. Açıklamaları içeren bir eğitim için Gerrit/Eğitim sayfasına bakın.

Prerequisites

1. Git'i yükle ve yapılandır.
2. Create a new SSH key to use with Wikimedia Gerrit:
   • Run the following from your terminal, substituting your email address:

     ssh-keygen -t ed25519 -C "your_email@example.com"

   • At the "Enter a file in which to save the key" prompt, you can press Enter to accept the default if this is your first SSH key. Otherwise, customize it to something like /Users/YOUR_NAME/.ssh/id_wikimedia_gerrit
   • At the "Enter passphrase:" prompt, choose a strong passphrase. You will typically have to the first time on a given day when pulling or sending change requests.
3. Bir Wikimedia geliştirici hesabı oluşturun. Then, log in on gerrit.wikimedia.org and add your public key to your account. The public key is the content of /Users/you/.ssh/id_wikimedia_gerrit.pub
4. Configure Git to set your email address, name, and SSH username.

Kodu alın:

Clone the repository using the command in the repository browser (e.g. https://gerrit.wikimedia.org/g/mediawiki/core). You can find these on the list, or from the extension infobox on mediawiki.org. The most commonly cloned repositories are:

MediaWiki çekirdeği için: git clone https://gerrit.wikimedia.org/r/mediawiki/core.git mediawiki

Veya bir uzantı için: git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/<extension>.git

Veya bir görünüm için: git clone https://gerrit.wikimedia.org/r/mediawiki/skins/<skin>.git

Write your patch

Start your branch from the latest production branch:

mediawiki$ git checkout master
mediawiki$ git pull
mediawiki$ git checkout -b anlamlı-dal-adı

NOTE: In some cases, the production branch may be called "production" or "main" and require a modified checkout command such as:

mediawiki$ git checkout production

mediawiki$ git checkout main

Now you can edit the code to make and test your changes. Kod hazır olduğunda:

• git commit --all Gerrit dünyasında bunu dal başına sadece bir kez yapmalısınız! To fix mistakes, use git commit --amend.
• git show Göndermek istediğinizi gönderdiğinizden emin olun. Çıkmak için "q" tuşuna basın.
• git review Bu, kodunuzu Gerrit'e gönderir. If you receive an error and have previously installed the older "gerrit-tools" program, install "git-review" instead.

You are encouraged to invite one or two maintainers as reviewers on your change. After creating the change request, the git review will have printed the URL for you change request. You can also find your changes through your Gerrit dashboard. "Reviewers" altında, "Add Reviewer" düğmesini tıklayın. Giriş kutusuna bir gözden geçiren adı yazın. İncelemek üzere kimi davet edeceğinizi bilmiyorsanız, düzenlediğiniz bileşen için sürdürücüsü deneyin veya IRC (#mediawiki ^bağlan) üzerinden isteyin.

Update your patch

İnceleyen sizden bir değişiklik yapmanızı isterse, bunu yapın ve taahhüdünüzü değiştirin:

• git review -d ekinin kimliğini düzele veya URL'sini değiştir ör. 1234 içinde https://gerrit.wikimedia.org/r/1234 veya $3 This downloads and checks out the change request from Gerrit.
• Kaynak dosyalarda gerekli değişiklikleri yapın.
• git commit --all --amend Bunu bir kereden fazla yapabilirsiniz. Teslim mesajını değiştirebilirsiniz, ancak "Change-Id" satırını olduğu gibi bıraktığınızdan emin olun.
• git review Bu, aynı Gerrit değişikliğinde yeni bir yama kümesi oluşturur ve kodu tekrar incelemesi için bir davetiye gönderir.

See also

• Taahhüt mesajı yönergelerini takip etmeyi unutmayın.
• See also Getting reviews