Kod Joomla'ya nasıl katkıda bulunabilirim?


19

Kodun https://github.com/joomla/joomla-cms adresinden (en azından CMS için) yönetildiğini ve kodun eklenmesini önermek için çekme istekleri göndermem gerektiğini biliyorum.

Özellikle katkılarımı yönetmek ve kod doğru yere alır emin olmak için herhangi bir iyi ipuçları ile ilgileniyorum.

Farklı katkıları yönetmek için çatallı repoda farklı şubeler kullanmalı mıyım? Öyleyse, bu dalı Joomla deposundaki ana şubelere geri bağlamanın en iyi yolu nedir?

Çatallı kopyamı güncel tutmanın iyi bir yöntemi var mı?

Bu süreci yönetmek için iyi bir akış önerisi gerçekten yararlı olacaktır!

Yanıtlar:


10

Yapacağınız her Çekme Talebi için özel bir şubeye sahip olmak her zaman iyidir.

Güncel yeni bir şube oluşturmanın en basit yollarından biri, dosyayı orijinal depodaki dosyayı düzenlemek için GitHub web gui'yi kullanmaktır. Kaydederken, GitHub çatalınızda otomatik olarak düzenlediğiniz dalı temel alarak yeni bir dal oluşturur. Daha fazla dosya düzenlemek istiyorsanız, dosyaları yeni oluşturulan ve güncel dalınızda düzenleyebilirsiniz.

Git'e biraz aşina iseniz, çatallı hazırlama dalınızı akış yukarı orijinal dal ile yeniden birleştirirsiniz, böylece yeni dallar oluşturmadan önce senkronize olur. Ayrıca, bir PR'yi güncellemeniz gerekiyorsa, master'ı birleştirmek yerine onu yeniden adlandırmanız önerilir. Her iki yol da işe yararken, birleştirme taahhütleri sadece kötü bir tarih yaratır ve ezilmesi daha zordur.

Genel olarak, PR'ler "atom" olmalıdır. Bu, bir şeyi düzeltmeye çalışırsanız, yalnızca söz konusu hatayı düzeltir. Aynı PR'da iki farklı hatayı düzeltmeyin ve ayrıca kod stili düzeltmeleri yapmayın. Halkla İlişkiler beklenenden biraz daha uzun yaşarsa, test edilmesi daha kolay ve çatışma yaratma olasılığı daha düşüktür.

Ve elbette ne yapmak istediğinize dair iyi bir açıklama ve sorunu yeniden oluşturmak ve düzeltmenizi test etmek için test talimatları ekleyin :-)


4

Katkılarınızı gruplandırmanıza yardımcı olan büyük bir şey, her bir katkıyı ayrı, uygun şekilde adlandırılmış bir şubeye taşımaktır. Bir özellik ekliyorsanız, bir önek kullanın feature-ve şube adı için bir veya iki kelime özellik açıklaması ekleyin. JFormSınıfta bir hata düzeltmesi varsa kullanın bugfix-jform. Bu, git dallarınızı kontrol ederek üzerinde çalıştığınız şeyi tanımlamayı gerçekten kolaylaştırır git branch -a.

Sitemizi kullandığınızda şunları okuyup anladığınızı kabul etmiş olursunuz: Çerez Politikası ve Gizlilik Politikası.
Licensed under cc by-sa 3.0 with attribution required.