You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Duyuru: Bu projede yönetici olmak ve projenin sürdürülmesine yardımcı olmak ister misiniz?? Eğer ilgileniyorsanız, bana Twitter'dan DM atabilir ve klavuz'u inceleyebilirsiniz.
Giriş
Bu eğitim aracılığıyla Github üzerinde ilk kez katkıda bulunacak kişilerin, basit ve kolay bir projeye katılmalarına yardımcı olunması amaçlanmıştır.
Eğitim yeni başlayanlar için olmak ile birlikte <a href="" target=""></a> bağlantı etiketini nasıl yazacağınızı ve düzenleyeceğinizi biliyorsanız, uygulamamızı başarabilirsiniz.
Ayrıca biraz daha deneyim sahibi ancak ilk açık kaynak katkısını yapmak veya konu ile ilgili daha fazla güven ve ekstra deneyim amacıyla katkıda bulunmak isteyenler içindir.
Neden bunu yapmam gerekiyor?
Hevesli veya deneyimli herhangi bir web geliştiricisinin Git versiyon kontrolünü ve herkes tarafından kullanılan en popüler Git barındırma hizmeti olan GitHub’ı kullanması gerekir. Github Aynı zamanda Açık Kaynak topluluğunun da kalbidir. GitHub'ı rahat kullanmak önemli bir beceridir. Github üzerinde bir projeye katkıda bulunmak kendinize olan güveninizi arttıracak ve size GitHub profilinizde sunabileceğiniz bir içerik vererek profil değerinizi arttıracaktır.
Yeni bir geliştiriciyseniz, Git ve GitHub'ı öğrenmeniz gerekip gerekmediğini merak ediyorsanız işte cevap: Git'i Dün Öğrenmiş Olmalıydın.
Ne katkıda bulunacağım?
Proje web sayfası'ndaki bunun gibi bir kartla katkıda bulunacaksınız. Üzerinde Adınızı, Twitter kullanıcı adınızı, kısa bir açıklamayı ve tavsiye ettiğiniz web geliştiricileri için faydalı kaynaklara yönelik 3 bağlantıyı içerecektir.
HTML dosyasının içindeki kart şablonunun bir kopyasını oluşturacak ve kendi bilgilerinizle özelleştireceksiniz.
• Alternatif olarak, Git'i komut satırında kullanmakta rahatsanız, yapabileceğiniz ilk katkılar, gerekli komutlar için rehber olarak hizmet edebilecek benzer bir projedir. VEYA
VS Code kullanıyorsanız, VS Code entegre Git ile birlikte gelir ve ihtiyacımız olanı doğrudan düzenleyiciden yapmanızı sağlar.
Ancak bu eğitimi uygulamanın en basit ve en kolay yolu GitHub Desktop kullanmaktır.
Artık hazır olduğunuza göre, projeye katkıda bulunma işine geçebiliriz.
Katkı
10 kolay adımda açık kaynağa katkıda bulunun.
Tahmini süre: 30 dakikadan az.
Adım 1: Bu depoyu çatallayın(fork)
Buradaki amaç, bu projenin bir kopyasını oluşturmak ve hesabınız bünyesine yerleştirmektir.
GitHub'da bir proje depo(repo) olarak adlandırılmakta, çatal(fork) ise bunun kopyalanmasıdır.
Bu reponun ana sayfa'sında (main) olduğunuzdan emin olun.
Fork butonuna basın
Artık kendi hesabınızda projenin tam bir kopyasına sahipsiniz.
Adım 2: Depoyu klonlayın(clone)
Şimdi projenin yerel bir kopyasını oluşturmak istiyoruz. Yani kendi cihazımıza kaydedilmiş bir kopya.
GitHub masaüstü uygulamasını açalım. Uygulamada:
Dosya'ya ve ardından Depoyu klonla'ya tıklayın
GitHub'da projelerimizin ve forkladıklarımızın bir listesini göreceğiz.
Forklanmış bir projenin solunda çatal sembolü olacaktır..
Forkladığınız projenin kendi GitHub kullanıcı adı olacaktır.
Proje sabit diskinize kopyalanırken bu biraz zaman alacaktır. Genellikle varsayılan dizini korumanız önerilmektedir. ..\Documents\GitHub.
Artık projenin yerel bir kopyasına sahipsiniz.
Adım 3: Yeni bir şube(branch) oluşturun
Depo klonlandıktan ve GitHub masaüstünde açıldıktan sonra yeni bir şube(branch) oluşturma zamanı gelmiştir.
Dal(branch), değişikliklerinizi projenin Master adlı ana bölümünden ayrı tutmanın bir yoludur. Örneğin, işler ters giderse ve değişikliklerinizden memnun değilseniz, şubeyi silmeniz durumunda ana proje etkilenmeyecektir.
Mevcut şube'ye(current) tıklayın
Ardından Yeni'ye tıklayın
Şubenize(branch) bir isim verin
Create branch'ı tıklayın
İstediğiniz bir isim koyabilirsiniz, ancak bu dal(branch) projeye adınızın olduğu bir kart eklemek amacıyla olduğundan, your-name-card şeklinde isimlendirmek iyi bir uygulama olacağından bu dalın amacını açık tutar.
Yeni şubenizi(branch) Github'da yayınlayın
Şimdi ana daldan ayrı yeni bir dal oluşturdunuz.
Sonraki adımlar için bu dalda çalıştığınızdan emin olun. Bulunduğunuz şubenin adını GitHub masaüstü uygulamasının üst orta kısmında Current branch şeklinde yazdığını göreceksiniz.
Lütfen master branch üzerinde çalışmayın
Adım 4: index.html dosyasını açın
Şimdi düzenleyeceğimiz dosyayı favori kod düzenleyicinizle açmanız gerekiyor.
Bilgisayarınızdaki proje klasörünü bulun. Varsayılanı koruduysanız bu şöyle bir şey olmalıdır your-computer > Documents > GitHub > Contribute-To-This-Project
index.html dosyası doğrudan Contribute-To-This-Project klasöründedir.
Kod düzenleyicinizi (Sublime, VS Code, Atom..etc) açın ve Open file komutunu kullanın ve index.html dosyasını projenin ana dizininde bulun.
Alternatif olarak, dosyayı sabit sürücünüzde bulabilir, sağ tıklayıp düzenleyicinizle açabilirsiniz.
Artık düzenleyeceğiniz dosya düzenleyicinizde açık ve üzerinde değişiklik yapmaya hazırsınız.
Adım 5: Kart şablonunu kopyalayın
Üzerinde çalışmaya başlamak için kart şablonunun bir kopyasını oluşturacağız
Html dosyasının en üstünde, <head> ve <header> bölümlerinin altında == TEMPLATE == etiketli bölümü bulacaksınız.
Contributor card START yorumundan Contributor card END yorumuna, resimdeki kırmızı kare içindeki her şeyi kopyalayın.
Her şeyi doğrudan yapıştırılacak yeri belirten yorumun altına yapıştırın.
Kartın başlangıcının öncesi ile sonununun ardında tek bir satır boşluk olduğundan emin olun. Bu kodumuzu olabildiğince okunabilir tutmak için iyi bir uygulamadır.
Asla linter veya stil formatlayıcı kullanmayın. Proje daha güzel bir kuruluma sahiptir.
Artık, kişiselleştirmeniz ve düzenlemeniz için size ait kartınız var.
Adım 6: Değişikliklerinizi uygulayın
Şimdi kartımızdaki özelleştirilebilir alanları değiştirerek html düzenlemeye başlayacağız.
Twitter dışında bir platform kullanmayı tercih ederseniz twitter simgesini değiştirmeniz gerekecektir <i class="fa fa-twitter"></i>. Font Awesome Icons'a giderek doğru simgeyi bulmanız sonrasında yalnızca fa-twitter bölümünü örneğin fa-facebook gibi yeni simgeyle değiştirebilirsiniz.
Bize kendin hakkında birşeyler söyle
Kısa ve güzel tut. Bunu blog gönderisinden çok bir tweet gibi düşünebilirsiniz
Web geliştirme için yararlı olan 3 kaynağa ait bağlantının topluluk ile paylaşılması
Bu herhangi bir şey, video, konuşma, podcast, makale, referans veya araç olabilir
Yeni başlayan biriyseniz, bundan korkmayın, basit olduğunu düşünseniz bile bildiklerinizi paylaşın. Kaç kişinin faydalanacağına şaşıracaksınız
Link: # değiştirilerek buraya bağlantı eklenir href="here"
Title: Kısa bir başlık açıklaması yazın title="here"
Name: Metin alanına kaynağın adını yazın >here</a>
Tüm değişikliklerinizi kaydettiğinizden emin olun.
Değişikliklerinizi test edin. BU ÖNEMLİ! Html dosyasını tarayıcınızda açın (üzerine çift taklayarak açabilirsiniz) ve kartınızın sitede nasıl görüneceğine bakın. Bağlantılarınızı tıklayın ve çalıştıklarından emin olun. Konsolu açın (Ctrl + Shift + J (Windows / Linux) veya Cmd + Opt + J (Mac)) ve hata mesajı olmadığını kontrol edin.
Harika, kodunuzu düzenlemeyi bitirdiniz! Sonraki adımlarda, değişikliklerinizi GitHub'a gönderecek ve ardından ana projeyle birleştirilmek(merge) üzere sunacaksınız.
Adım 7: Değişikliklerinizi kabul edin(commit)
GitHub masaüstü uygulamasına geri dönün.
Değişiklikleriniz staging alanına otomatik olarak eklenecektir.
Bu, Git'in şuana kadar mevcut gerçekleştirilen tüm değişiklikleri kaydettiği anlamına gelir.
Bunun uygulamaya yansıdığını görebilirsiniz. Dosyaya eklediğiniz her şey yeşil olacak ve silme işlemleri kırmızı olarak gösterilecektir.
Bir sonraki adıma Commit denir
Bu kabaca "değişiklikleri onayla" anlamına gelir
GitHub masaüstü başlığınız böyle görünmelidir
Geçerli depoda proje adının yanındaki çatal sembolüne dikkat edin
Mevcut şubeniz 3. adımda verdiğiniz isme sahip olacaktır
Taahhüt(commit) etmek için Summary(özet) alanını doldurmalısınız
Bu, neyi değiştirdiğinizi açıklayan taahhüt mesajıdır
Bu durumda "Kart bilgilerimi ekle" mantıklı bir mesaj olacaktır
İsteğe bağlı olarak daha ayrıntılı bir Açıklama ekleyebilirsiniz.
Commit butonuna basınız Butonda şöyle bir şey yazacaktır Commit to "your-branch-name"
Adım 8: Değişikliklerinizi GitHub'a aktarın(push)
Değişiklikleriniz artık kaydedildi veya taahhüt(commit) edildi. Ancak bunlar yalnızca yerel olarak, yani bilgisayarınızda kaydedilmiştir.
Yerel değişiklikleri Github'daki deponuzla senkronize etmeye Push denir. Yerel deponuzdaki değişiklikleri Github'taki uzak depoya "ittirme(pushlama)" işlemi gerçekleştirilecektir.
Push Butonuna tıklayınız
Birkaç saniye sonra işlem tamamlanır ve artık bu dalın(branch) tam olarak aynı kopyası hem makinenizde hem de GitHub'da bulunur.
Adım 9: Bir PR(Çekme İsteği) Gönderin(Pull Request)
Şimdiye kadar yaptığınız tüm işler, hatırladığınız gibi kendi GitHub hesabınızda bulunan çatallanmış proje dahilindeydi(fork).
Şimdi, değişikliklerinizi birleştirilecek ana projeye gönderme zamanı.
Orijinal proje yürütücüsünden, gerçekleştirmiş olduğunuz değişikliklerinizi projelerine "çekmesini" istediğiniz için buna Pull Request denir.
GitHub'da çatalınızın ana sayfasına gidin (üstte çatal simgesi ve kendi kullanıcı adınız olacaktır).
Deponun üst kısmına doğru, yeşil bir düğme ile vurgulanmış bir çekme talebi mesajı göreceksiniz. (Pull request)
Compare and pull request butonuna tıklayınız
Open a pull request sayfası bu şekilde gözükmektedir.
UNUTMAYIN, dalınızı çatalınızdaki Master dalıyla değil, orijinal projeyle birleştirmeye çalışıyorsunuz.
Aşağıdaki resim, çekme isteğinizin başlığının nasıl görünmesi gerektiği hakkında bir fikir verecektir.
Solda orijinal proje ve ardından ana dal bulunur. Sağda ise çatalımız ve oluşturduğumuz dal vardır.
Çekme(Pull request) isteği oluşturun
Bir başlık yazın
Açıklamaya isteğe bağlı bilgiler ekleyin
Create pull request butonuna tıklayın
Tüm seçenekler sizi şaşırtmasın. Şimdilik sadece bu üç adımı yapmanız gerekiyor.
Allow edits from maintainers (Bakımcıların düzenlemelerine izin ver) seçeneğini işaretli bırakın.
Şimdi, proje yürütücüsüne bir Pull Request(Çekme talebi) gönderilecektir. İncelenip kabul edildiği anda değişiklikleriniz proje web sayfası'nda görünecektir.
Adım 10: Kutlama
Bu kadar. Başardın! GitHub'ta açık kaynağa katkıda bulundunuz.
Değişiklikleriniz hemen görünmeyecektir; öncelikle proje yürütücüsü tarafından gözden geçirilip kabul edilmeli ve birleştirilmelidir(merge). Bir kez birleştirildikten sonra kartınız sayfada görünür ve canlı olacaktır.
Gözden geçiren kişinin bir PR üzerinde değişiklik istemesi çok normaldir. Başınıza gelirse iyi bir uygulama olarak düşünün. Yorumlara ve istenen değişikliklere dikkat edin. İstenen değişiklikleri yaptıktan sonra (size ait branch'a geri döndüğünüzde) tek yapmanız gereken değişikliklerinizi taahhüt(commit) etmek ve push etmektir. PR, yeni değişikliklerle otomatik olarak güncellenecektir.
En kısa zamanda incelemeye ve birleştirmeye çalışacağıma söz veriyorum ama bunu boş zamanlarımda yapıyorum, bu yüzden birkaç gün gecikme kaçınılmaz.
Sonraki adımlar
Merge edilmiş Çekme Talebinizi(pull request) kontrol etmek için bir süre sonra tekrar gelin.
Değişiklikleriniz onaylandığında veya ek değişiklikler istendiğinde GitHub'dan bir e-posta almalısınız. Ve aynı zamanda PR nihayet master ile birleştiğinde ve kartınız eklendiğinde de.
Bu projeyi faydalı bulduysanız, lütfen sayfanın üst kısmına bir ⭐ yıldız ⭐ verin ve projenin yayılmasına yardımcı olmak için bu konuda Tweet atın.
Beni takip edebilir ve Twitter veya bu diğer seçeneklerden herhangi birini kullanarak iletişime geçebilirsiniz.
Bu açık kaynaklı bir projedir, dolayısıyla kartınız ile katkıda bulunmanın yanı sıra hataları düzeltmeye, iyileştirmelere veya yeni özellikleri eklemeye yardımcı olabilirsiniz. Bir issue açabilir ve pull request gönderebilirsiniz.
Topluluğumuzu geliştirmeye yardımcı olmak için çekme isteklerinin yanında bulunan Github Tartışmalar sekmesine bakabilirsiniz. Bu alan kendinizi tanıtabileceğiniz, açık kaynak hakkında daha derin tartışmalara girebileceğiniz ve proje sorumluları ile iletişim kurabileceğiniz bir yerdir. Bu özelliği geliştirmemize ve topluluğumuzu geliştirmemize yardım edecek misiniz? -Bu projeye katkıda bulunduğunuz için teşekkür ederiz. Şimdi devam edebilir ve diğer projelere katkıda bulunmayı deneyebilirsiniz; acemi dostu katkı seçenekleri için Good First Issue etiketini arayabilirsiniz.
Ayrıca, PR'leri gözden geçirme ve birleştirme konusunda bana yardım edecek ortak çalışma arkadaşları arıyorum. Daha gelişmiş Git alıştırması yapmak istiyorsanız, lütfen bana Twitter'dan bir DM atın ve maintainer's guide kaynağını okuyun.
Ayrıca, özellikle #GoogleUdacityScholars The Google Challenge Scholarship: Front-End Web Dev, 2017 Avrupa kümesindeki büyük topluluktan ilham almıştır.
