|
4 | 4 | - [Çekirdek Geliştirme Tartışmaları](#core-development-discussion)
|
5 | 5 | - [Yeni Özellikler](#new-features)
|
6 | 6 | - [Bug'lar](#bugs)
|
| 7 | +- [Liferaft Uygulamalarının Oluşturulması](#creating-liferaft-applications) |
| 8 | +- [Liferaft Uygulamalarının Çekip Alınması](#grabbing-liferaft-applications) |
7 | 9 | - [Hangi Dal?](#which-branch)
|
8 | 10 | - [Güvenlik Açıkları](#security-vulnerabilities)
|
9 | 11 | - [Kodlama Biçimi](#coding-style)
|
|
13 | 15 |
|
14 | 16 | Laravel açık kaynak bir projedir ve Laravel'in geliştirilmesi için herkes ona katkıda bulunabilir. Beceri düzeyi, cinsiyeti, ırkı, dini ve milliyeti ne olursa olsun katılımcıları bekliyoruz. Farklı, canlı bir topluluğa sahip olmak frameworkün temel değerlerinden biridir!
|
15 | 17 |
|
16 |
| -Aktif işbirliğini teşvik etmek amacıyla, Laravel şu anda bug bildirimlerini değil, sadece çekme isteklerini (pull requests) kabul etmektedir. **"Bug bildirimleri" başarısız kalan bir unit testini içeren bir çekme isteği şeklinde gönderilebilir.** Başarısız kalan bir unit testi, geliştirme ekibine bu bug'ın mevcut olduğunun "kanıtını" gösterir ve geliştirme ekibi bu bug'ı hallettikten sonra da bug'ın düzeltildiğinin güvenilir bir göstergesi olarak hizmet eder. |
| 18 | +Aktif işbirliğini teşvik etmek amacıyla, Laravel şu anda bug bildirimlerini değil, sadece çekme isteklerini (pull requests) kabul etmektedir. "Bug bildirimleri" başarısız kalan bir unit testini içeren bir çekme isteği şeklinde gönderilebilir. Alternatif olarak, bir sandbox Laravel uygulaması içindeki bir bug gösterimi [ana Laravel ambarına](https://github.com/laravel/laravel) bir çekme isteği olarak gönderilebilir. Başarısız kalan bir unit testi veya bir sandbox uygulaması, geliştirme ekibine bu bug'ın mevcut olduğunun "kanıtını" gösterir ve geliştirme ekibi bu bug'ı hallettikten sonra da bug'ın düzeltildiğinin güvenilir bir göstergesi olarak hizmet eder. |
17 | 19 |
|
18 | 20 | Laravel kaynak kodu Github'da yönetilmektedir ve Laravel projelerinin her biri için ambarlar vardır:
|
19 | 21 |
|
@@ -44,15 +46,87 @@ Yeni özellikler eklerken unit testlerini eklemeyi unutmayın! Unit testleri, ye
|
44 | 46 | <a name="bugs"></a>
|
45 | 47 | ## Bug'lar
|
46 | 48 |
|
| 49 | +### Unit Test Yoluyla |
| 50 | + |
47 | 51 | Bug'lar için çekme istekleri, öncesinde Laravel geliştirme ekibiyle tartışılmaksızın gönderilebilir. Bir bug düzeltmesi gönderirken bug'ın asla tekrar gözükmeyeceğinden bizi emin eden bir unit testi eklemeye çalışınız!
|
48 | 52 |
|
49 | 53 | Eğer frameworkte bir bug bulduğunuza inanıyor, fakat onu nasıl düzelteceğinizden emin değilseniz, lütfen başarısız kalan bir unit testi içeren bir çekme isteği gönderin. Başarısız kalan bir unit testi, geliştirme ekibine bu bug'ın mevcut olduğunun "kanıtını" gösterir ve geliştirme ekibi bu bug'ı hallettikten sonra da bug'ın düzeltildiğinin güvenilir bir göstergesi olarak hizmet eder.
|
50 | 54 |
|
51 | 55 | Şayet bir bug için başarısız kalan bir unit testinin nasıl yazılacağından emin değilseniz, frameworke dahil edilmiş diğer unit testlerini gözden geçirin. Hala yapamadınızsa, `#laravel` IRC channel (Freenode)'da yardım isteyebilirsiniz.
|
52 | 56 |
|
| 57 | +### Laravel Liferaft Yoluyla |
| 58 | + |
| 59 | +Sorununuz için bir unit testi yazamıyorsanız, Laravel Liferaft size sorunu yeniden oluşturan bir demo uygulaması oluşturma imkanı verir. Liferaft, Laravel ambarının fork edilmesi ve ambara çekme isteklerinin gönderilmesini otomatize de edebilir. Liferaft uygulamanız gönderildikten sonra, bir Laravel geliştiricisi sizin uygulamanızı [Homestead](/docs/homestead) üzerinde çalıştırabilir ve sorununuzu gözden geçirebilir. |
| 60 | + |
| 61 | +<a name="creating-liferaft-applications"></a> |
| 62 | +## Liferaft Uygulamalarının Oluşturulması |
| 63 | + |
| 64 | +Laravel Liferaft Laravele katkıda bulunmak için yeni ve yenilikçi bir yol sağlar. İlk olarak Composer aracılığıyla Liferaft CLI aracını yüklemeniz gerekecek: |
| 65 | + |
| 66 | +### Liferaft Yüklenmesi |
| 67 | + |
| 68 | + composer global require "laravel/liferaft=~1.0" |
| 69 | + |
| 70 | +Terminalinizden `liferaft` komutu çalıştırıldığı zaman `liferaft` çalıştırılabilir dosyasının bulunması için PATH'inizde `~/.composer/vendor/bin` dizini olduğundan emin olun. |
| 71 | + |
| 72 | +### GitHub İle Giriş Yapılması |
| 73 | + |
| 74 | +Liferaft ile çalışmaya başlamadan önce, bir GitHub kişisel erişim tokenine kayıt olmanız gerekir. [GitHub settings panelinizden](https://github.com/settings/applications) bir kişisel erişim tokeni üretebilirsiniz. GitHub tarafından seçilmiş durumdaki default kapsamlar yeterli olacaktır; bununla birlikte, eğer isterseniz, Liferaft'ın sizin eski sandbox uygulamalarınızı silebilmesi için `delete_repo` kapsamı imtiyazını alabilirsiniz. |
| 75 | + |
| 76 | + liferaft auth my-github-token |
| 77 | + |
| 78 | +### Yeni Bir Liferaft Uygulaması Oluşturulması |
| 79 | + |
| 80 | +Yeni bir Liferaft uygulaması oluşturmak için, `new` komutunu kullanmanız yeterlidir: |
| 81 | + |
| 82 | + liferaft new my-bug-fix |
| 83 | + |
| 84 | +Bu komut birkaç şey yapacaktır. Birincisi, [Laravel GitHub repository'yi](https://github.com/laravel/laravel) sizin GitHub hesabına fork edecektir. Daha sonra bu fork edilen ambarı sizin makinenize klonlayacak ve Composer bağımlılıklarını yükleyecektir. Ambar yüklendikten sonra, Liferaft uygulaması içerisinde sorunu yeniden oluşturmaya başlayabilirsiniz! |
| 85 | + |
| 86 | +### Sorununuzun Yeniden Oluşturulması |
| 87 | + |
| 88 | +Bir Liferaft uygulaması oluşturulmasından sonra, basitçe sorununuzu yeniden oluşturun. Rotalarınızı tanımlayabilir, Eloquent modelleri oluşturabilir ve hatta veritabanı migrasyonları üretebilirsiniz! Tek gereklilik, uygulamanızın yeni bir [Laravel Homestead](/docs/homestead) sanal makinesi üzerinde çalışabiliyor olmasıdır. Bu, Laravel geliştiricilerine sizin uygulamanızı kendi makinelerinde kolaylıkla çalıştırabilme imkanı verir. |
| 89 | + |
| 90 | +Sorununuzu Liferaft uygulaması içerisinde yeniden oluşturduktan sonra, gözden geçirme için onu tekrar Laravel ambarına geri göndermeye hazırsınız demektir! |
| 91 | + |
| 92 | +### Uygulamanızın Gözden Geçirme İçin Gönderilmesi |
| 93 | + |
| 94 | +Sorununuzu yeniden oluşturduktan sonra, onu gözden geçirme için göndermenin tam zamanıdır! Bununla birlikte, öncelikle Liferaft uygulamanız içerisinde üretilmiş olan `liferaft.md` dosyasını tamamlamanız gerekir. Bu dosyanın ilk satırı çekme isteğinizin başlığı olacaktır. İçeriğin geri kalan kısı çekme isteğinin gövdesinde yer alacaktır. Tabii ki, GitHub Flavored Markdown desteklenmektedir. |
| 95 | + |
| 96 | +Bu `liferaft.md` dosyasını doldurduktan sonra, değişikliklerinizin tamamını GitHub ambarınıza gönderin. Sonra da, uygulamanızın dizininden Liferaft `throw` komutunu çalıştırın: |
| 97 | + |
| 98 | + liferaft throw |
| 99 | + |
| 100 | +Bu komut Laravel GitHub ambarı için bir çekme isteği oluşturacaktır. Bir Laravel geliştiricisi sizin uygulamanızı kolaylıkla çekip alabilecek ve kendi Homestead ortamlarında çalıştırabilecektir! |
| 101 | + |
| 102 | +<a name="grabbing-liferaft-applications"></a> |
| 103 | +## Liferaft Uygulamalarının Çekip Alınması |
| 104 | + |
| 105 | +Laravele katkıda bulanmak mı istiyorsunuz? Liferaft Liferaft uygulamalarını yüklemek ve onları kendi [Homestead ortamınızda](/docs/homestead) görme işini sancısız bir hale getirir. |
| 106 | + |
| 107 | +İlk olarak, kolaylık olması için, [laravel/laravel](https://github.com/laravel/laravel) ambarını kendi makinenizde bir `liferaft` dizinine klonlayın: |
| 108 | + |
| 109 | + git clone https://github.com/laravel/laravel.git liferaft |
| 110 | + |
| 111 | +Ondan sonra, `develop` dalını yoklayın, böylece hem stabil hem de gelecek Laravel sürümlerini hedef alan Liferaft uygulamalarını yükleyebileceksiniz: |
| 112 | + |
| 113 | + git checkout -b develop origin/develop |
| 114 | + |
| 115 | +Sonra da, sizin ambar dizininden Liferaft `grab` komutunu çalıştırabilirsiniz. Örneğin, #3000 çekme isteği ile ilişkili Liferaft uygulamasını yüklemek istiyorsanız, aşağıdaki komutu çalıştırmalısınız: |
| 116 | + |
| 117 | + liferaft grab 3000 |
| 118 | + |
| 119 | +Bu `grab` komutu sizin Liferaft dizininizde yeni bir dal oluşturacak ve belirtilen çekme isteği için değişiklikleri çekecektir. Liferaft uygulaması yüklendikten sonra, [Homestead](/docs/homestead) sanal makineniz aracılığıyla dizini hizmete sokmanız (serve etmeniz) yeterlidir! Sorunu debug ettikten sonra, doğru düzeltme ile [laravel/framework](https://github.com/laravel/framework) ambarına bir çekme isteği göndermeyi unutmayın! |
| 120 | + |
| 121 | +Fazladan bir saatiniz var ve rastgele bir sorunu çözmek istiyorsunuz? Bir çekme isteği ID'si olmaksızın, `grab` komutunu tek başına çalıştırın: |
| 122 | + |
| 123 | + liferaft grab |
| 124 | + |
53 | 125 | <a name="which-branch"></a>
|
54 | 126 | ## Hangi Dal?
|
55 | 127 |
|
| 128 | +> **Not:** Bu kesim esas olarak [laravel/framework](https://github.com/laravel/framework) ambarına çekme istekleri gönderilmesi için geçerlidir, Liferaft uygulamaları için değildir. |
| 129 | +
|
56 | 130 | **Tüm** bug düzeltmeleri en son kararlı dala gönderilmelidir. Bug düzeltmeleri, düzeltilen özellikler sadece çıkacak sürümde mevcut olmadığı sürece **asla** `master` dalına gönderilmemelidir.
|
57 | 131 |
|
58 | 132 | Güncel Laravel sürümü ile **geriye dönük tam uyumlu** **Minor** özellikler en son kararlı dala gönderilebilir.
|
|
0 commit comments