Bir katkı, birçok derneğe fayda.

Katkı yalnızca kod değildir.

Projenin katkı rehberi, geliştirme kadar test, dokümantasyon, tanıtım ve topluluk çalışmalarını da kapsar. Bir dernekte karşılaştığınız ihtiyacı anlatmanız bile yeni bir iyileştirmenin başlangıcı olabilir.

İlk katkınız için

1. Açık sorunları inceleyin. Benzer bir öneri veya hata kaydı olup olmadığını kontrol edin.
2. Değişikliği küçük tutun. Tek bir sorunu çözen değişikliklerin değerlendirilmesi kolaydır.
3. Çözümü doğrulayın. Değişen davranışı doğrulayan testleri ekleyin ve ilgili kontrolleri çalıştırın.
4. Pull request açın. Neyi değiştirdiğinizi, neden gerekli olduğunu ve nasıl çalıştırılıp test edildiğini açıklayın.

Geliştiriciler için mimari notlar

Çekirdek app/, özellik modülleri modules/ altında bulunur. Çekirdek modüllere doğrudan bağımlı olmaz. Modüller çekirdeği ve açıkça tanımladıkları bağımlılıkları kullanır; diğer özelliklerle menü, slot, olay ve kayıt mekanizmaları üzerinden iletişim kurar.

• Yeni özelliklerde kurum adı ve adresi gibi değerleri sabitlemek yerine kurum ayarlarını kullanın.
• Yetki denetimlerinde mevcut yetki anahtarlarını ve modül kayıt mekanizmasını izleyin.
• Hesap değişikliklerini kişi kaydıyla eşitleyen model davranışlarını koruyun.
• E-posta ve SMS içeriklerini ortak şablon ve bildirim altyapısıyla tanımlayın.
• Modül testlerini modülün Tests/Feature dizininde tutun.

Modül klasörlerinde servis sağlayıcısı, rotalar, görünümler, modeller, migration dosyaları ve testler birlikte yer alır.

Göndermeden önce

Pull request açıklamasında çözülmek istenen sorunu ve kullanıcıya etkisini anlatın. Çalıştırılması gereken ek adımları, yapılandırma değişikliklerini ve doğrulama sonuçlarını belirtin. Büyük geliştirmeleri anlaşılır, bağımsız parçalara bölün.

Depodaki CONTRIBUTING.md, kod değişikliklerinin pull request olarak gönderilmesini ve test içermesini ister. Güncel proje kurallarını her katkı öncesinde kaynak depodan kontrol edin.

Kaynak katkı rehberi →