Katkıda bulunmanız hoş karşılanacaktır ve haklarınız korunacaktır.
Lütfen herhangi bir issue ya da pull request göndermeden önce aşağıda bulunan katkıda bulunma rehberini dikkatlice okuyun.
Bu proje açık kaynak kodludur, ve aynı şekilde, geliştiricileri özgür zamanlarını bu projeyi geliştirmek, diğer geliştiricilere faydalı olmak ve sağlanan kaynak kodu sürdürmek için kullanmaktadır. Bu sıkı çalışmalarının sonunda istismara uğramaları ya da öfke ile karşılaşmaları adaletsizce olacaktır.
Lütfen hata raporlarken ya da pull request gönderirken bu projeyi sürdüren geliştiricilere karşı dünyaya yazılım geliştiricilerin uygar ve özverili insanlar olduklarını gösterecek kadar hatırşinas olun.
Projenin bakımını üstlenen geliştiriciler için, bu projeye gönderilmekte olan tüm önerilerin belirli bir seviyede ve kalitede olmasını sağlamak bir görevdir. Farklı geliştiricilerin farklı becerileri, güçleri ve zayıflıkları vardır. Geliştiricilerin seçimlerine saygı gösterin ve eğer öneriniz kullanılmazsa ya da mantıklı bulunmazsa üzülmeyin.
Yeni özellikler ister ya da önerirken, öncelikle isteğinizin diğer kullanıcılar için de kullanışlı olup olmayacağını tartın. Açık kaynak kodlu projeler, sizden çok daha farklı ihtiyaçları olabilen bir çok geliştirici tarafından kullanılır. İsteğinizin tamamen size özel olması durumunda büyük ihtimalle projeye eklenmesi faydalı olmayacaktır
Bir issue doldururken:
- Yanlışlıkla meydana gelmiş bir olayı raporlamadığınızdan emin olmak için, yaşadığınız sorunu tekrar üretmeyi deneyin.
- İsteklerinizin proje içerisinde zaten bulunmadığından emin olun.
- Yaşadığınız sorun için geliştirme aşamasında bir çözüm olmadığından emin olmak için pull requestleri sekmesini inceleyin.
- Gönderdiğiniz özelliğin zaten geliştirilmemiş olduğundan emin olmak için pull requestleri sekmesini inceleyin.
Bir pull request göndermeden önce:
- Gönderdiğiniz özelliğin zaten geliştirilmemiş olduğundan emin olun.
- Yaşadığınız sorun için geliştirme aşamasında bir çözüm olmadığından emin olun.
Kaynak koda katkıda bulunmanız için sağlamanız gereken diğer özellikler aşağıda listelenmiştir:
-
PSR-2 Kodlama Standardı - Bu programlama stilinin uygulandığından emin olmak için PHP Code Sniffer kurmak en sık başvurulan yöntemdir.
-
Test Yazın! - Eğer gönderdiğiniz yamada test yoksa kabul edilmeyecektir.
-
Davranışsal değişiklikleri dokümante edin -
README.md
dosyasının veCHANGELOG.md
dosyasının davranışsal değişiklikleri içerdiğinden emin olun. -
Yayın döngümüzü göz önünde bulundurun - SemVer v2.0.0'ı takip etmeye çalışıyoruz. "Uygulama Programlama Arayüzlerini rastgele değiştirerek hatalara yol açmak bir seçenek bile değil".
-
Her isteğe bir pull request - Birden fazla şeyi değiştiriyorsanız, birden fazla pull request gönderin.
-
Uyumlu geçmiş gönderin - Her commit'inizin mesajının mantıklı olmasını tercih ederiz. Eğer aynı iş için birden fazla commit yapmak zorunda kaldıysanız, bize göndermeden önce ezin onları!.
Mutlu Kodlamalar!