Açık kaynağa neden katkıda bulunmalıyım?

Açık kaynağa katkıda bulunmak, hayal edebileceğiniz herhangi bir konuyu öğrenmek, öğretmek ve deneyim geliştirmek için faydalı bir yol olabilir.

İnsanlar neden açık kaynağa katkıda bulunur? Bunun bir sürü sebebi vardır!

Güvendiğiniz yazılımı geliştirme

Açık kaynak projelere katkıda bulunanların birçoğu projeyle kullanıcısı olarak tanışırlar. Kullandığınız açık kaynak bir yazılımda bir hata bulduğunuzda, kendiniz yamalayıp düzeltip düzeltemeyeceğiniz görmek için kaynağa bakmak isteyebilirsiniz. Bu durumda, yamanın yapılmasına katkıda bulunmak, arkadaşlarınızın (ve bir sonraki sürüme geçtiğinizde kendinizin de) bundan faydalanmasını sağlamak için en iyi yoldur.

Mevcut becerileri geliştirme

Kodlama, kullanıcı arayüzü tasarımı, grafik tasarımı, yazma veya düzenleme gibi konularda pratik arıyorsanız, herhangi bir açık kaynak projede sizin için mutlaka bir görev vardır.

Benzer şeylerle ilgilenen insanlarla tanışma

Sıcak, misafirperver topluluklarla açık kaynak projeler insanları yıllarca müdavimleri yaparlar. Pek çok insan, konferanslarda ya da açık kaynak projelerine katılarak, farklı konularla ilgili çevrimiçi gece sohbetlerine gireyecekleri ömür boyu sürecek arkadaşlıklar kurarlar.

Mentor bulma ve başkalarına öğretme

Paylaşımlı bir projede başkalarıyla çalışmak demek, işlerinizi nasıl yaptığınızı açıklamanın yanı sıra diğer insanlardan yardım istemek demektir. Öğrenme ve öğretme eylemleri, katılan herkes için tatmin edici bir aktivite olabilir.

İtibarınızı (ve kariyerinizi) geliştirmenize yardımcı olacak eserler oluşturma

Tanım olarak, açık kaynak kodlu çalışmaların tamamı kamuya açıktır; yapabileceklerinizin bir göstergesi olarak herhangi bir yerde göstermek için ücretsiz örneklere sahip olursunuz.

İnsani beceriler kazanma

Açık kaynak, çatışmaları çözmek, ekipleri organize etmek ve işlerin önceliklerini yönetmek gibi liderlik ve yönetim becerilerini uygulama fırsatları sunar.

Küçük bile olsa değişiklik yapabilme gücü verir

Açık kaynak geliştirmekten zevk alabilmek için ömür boyu katkıda bulunmanız gerekmez. Hiç bir web sitesinde bir yazım hatası gördünüz ve birisinin düzeltmesini dilediniz mi? Açık kaynak bir projede, bunu siz yapabilirsiniz. Açık kaynak, insanların yaşamları ve dünyayı nasıl tecrübe ettikleri konusunda kendilerini etkin hissetmelerine yardımcı olur ve bu kendi içinde memnuniyet vericidir.

Katkıda bulunmak ne demektir?

Açık kaynaklı bir projeye ilk defa katkıda bulunuyorsanız, bu süreç korkutucu olabilir. Doğru proje nasıl bulunur? Ya nasıl kodlanacağını bilmiyorsan? Ya bir şeyler ters giderse?

Endişe etmeyin! Açık kaynak kodlu bir projeye dahil olmanın çok farklı yolları vardır ve birkaç ipucu deneyiminizden en iyi şekilde yararlanmanıza yardımcı olacaktır.

Kod yazarak katkıda bulunmak zorunda değilsin

Açık kaynağa katkıda bulunma konusunda yaygın bir yanılgı, kod yazarak katkıda bulunmanız gerektiğidir. Aslında, genellikle en çok ihmal edilen veya göz ardı edilen projenin diğer kısımlarıdır. Bu tür katkılara katılmayı teklif ederek projeye büyük bir iyilik yapacaksınız!

Kod yazmayı sevseniz bile, diğer katkı türleri de bir projeye katılmak ve diğer topluluk üyeleriyle tanışmak için harika bir yoldur. Bu ilişkileri kurmak size projenin diğer bölümlerinde de çalışma fırsatı verecektir.

Etkinlik planlamayı sever misiniz?

  • NodeSchool için @fzamperin yaptığı gibi, proje hakkında atölye çalışmaları veya buluşmalar düzenleyin
  • Projenin konferansını düzenleyin (eğer varsa)
  • Topluluk üyelerinin doğru konferansları bulmasına ve konuşma için öneriler sunmasına yardımcı olun

Tasarlamayı sever misiniz?

  • Projenin kullanılabilirliğini geliştirmek için şablonları yeniden yapılandırın
  • Drupal’ın önerdiği gibi, projenin navigasyonunu veya menülerini yeniden düzenleyin ve bunu yapmak için hassas kullanıcı araştırması yapın
  • Projenin tutarlı bir görsel tasarıma sahip olması için bir stil rehberi hazırlayın
  • Hapi.js’in katılımcılarının yaptığı gibi t-shirtler veya yeni bir logo tasarlayın

Yazmayı sever misin?

  • Proje dokümantasyonunu yazın ve geliştirin
  • Projenin nasıl kullanıldığını gösteren örnekler oluşturun
  • Proje için bir bülten başlatın veya posta listesinden önemli noktaları açığa çıkarın
  • PyPA’nın katılımcılarının yaptığı gibi proje için dersler yazın
  • Projenin dokümantasyonu için çeviri yapın

Organize etmeyi sever misiniz?

  • Projeyi daha organize hale getirmek için benzer sorunları bağlantılayın ve yeni sorun etiketleri önerin
  • Açık sorunların üzerinden geçin ve eskileri kapatmayı önerin, @nzakas’ın ESLint için yaptığı gibi
  • Tartışmayı ileriye taşımak için açılan konular hakkında açıklayıcı sorular sorun.

Kod yazmayı sever misiniz?

  • @Dianjin’in Leaflet için yaptığı gibi çözülmesi gereken açık bir konu bulun
  • Yeni bir özellik yazmak için yardımcı olabilir misiniz diye sorun
  • Proje kurulumunu otomatikleştirin
  • Araçları ve testleri geliştirin

İnsanlara yardım etmeyi sever misiniz?

  • Proje hakkında soruları yanıtlayın. Örneğin, Stack Overflow’da (bu Postgres örneğinde olduğu gibi) veya Reddit’te
  • İnsanlar için açık konulardaki soruları cevaplayın
  • Tartışma panolarını veya konuşma kanallarını yönetmeye yardımcı olun

Başkalarına kod yazarken yardım etmeyi sever misiniz?

Sadece yazılım projeleri üzerinde çalışmak zorunda değilsiniz!

“Açık kaynak” genellikle yazılımla ilişkilendirilse de, her şey için işbirliği yapabilirsiniz. Açık kaynak projeleri olarak geliştirilen kitaplar, tarifler, listeler ve sınıflar var.

Örneğin:

Bir yazılım geliştiricisi olsanız bile, bir dokümantasyon projesi üzerinde çalışmak açık kaynak kodla başlamanıza yardımcı olabilir. Kod içermeyen projeler üzerinde çalışmak genellikle daha az korkutucu olur ve işbirliği süreci sizin güven ve deneyiminizi artırır.

Kendinizi yeni bir projeye yönlendirmek

Bir yazım hatasının düzeltilmesinden daha fazla olarak, açık kaynağa katkıda bulunmak, partideki bir grup yabancıyla konuşmaya çalışmak gibidir. Lamalar hakkında konuşmaya başlarsanız, akvaryum balığı ile ilgili derin bir tartışma yapıyorlarsa, muhtemelen size biraz garip bakarlar.

Kendi önerilerinizle kör bir şekilde atlamadan önce, odanın neler konuştuğunu öğrenmekle başlayın. Bunu yapmak, fikirlerinizi fark ettirme ve duyurma şansınızı arttırır.

Açık kaynak kodlu bir projenin anatomisi

Her açık kaynak topluluğu kendine özgüdür.

Bir açık kaynak projeye yıllarınızı harcamak, projeyi tanıdığınız anlamına gelir. Farklı bir projeye geçin; kelime, norm ve iletişim biçimlerinin tamamen farklı olduğunu göreceksiniz.

Bununla birlikte, birçok açık kaynak projenin benzer organizasyon yapılarını takip ettiği söylenebilir. Farklı topluluk rollerini ve genel süreci anlamak, yeni projeye hızlı bir şekilde odaklanmanıza yardımcı olacaktır.

Tipik bir açık kaynak projesi aşağıdaki insan türlerine sahiptir:

  • Yazar: Projeyi yaratan kişi(ler)/kurum(lar)
  • Sahip: Kurum veya depo üzerinde yönetim hakkına sahip kişi/kişiler (her zaman orijinal yazarla aynı olmayabilir)
  • Geliştiriciler: Vizyonu yönlendirmekten ve projenin organizasyonel yönlerini yönetmekten sorumlu olanlar ve katkıda bulunanlar (Projenin yazarları veya sahipleri de olabilirler)
  • Katkıda Bulunanlar: Projeye katkıda bulunan herkes
  • Topluluk Üyeleri: Projeyi kullanan insanlar. Sohbetlerde aktif olabilirler veya projenin yönü ile ilgili görüşlerini ifade edebilirler.

Daha büyük projeler ayrıca araç yönetimi, öncelik yönetimi, topluluk yönetimi ve etkinlik organizasyonu gibi farklı görevlere odaklanmış alt komitelere veya çalışma gruplarına sahip olabilir. Bu bilgileri bulmak için bir projenin “ekip” sayfasına veya yönetim dokümantasyon deposuna bakın.

Projelerin belgeleri de vardır. Bu dosyalar genellikle bir kütüphanenin dizin yapısının en üst seviyelerinde listelenir.

  • LICENCE: Tanım gereği her açık kaynak projenin bir açık kaynak lisansa sahip olması gerekir. Projenin lisansı yoksa açık kaynak değildir.
  • README: README, projeye yeni topluluk üyelerini karşılayan kullanım kılavuzudur. Projenin neden yararlı olduğunu ve nasıl başlayacaklarını açıklar.
  • CONTRIBUTING: README dosyaları projeyi insanların kullanmalarına yardımcı olurken, CONTRIBUTING dökümanları insanların projeye katkıda bulunmalarına yardımcı olur. Hangi tür katkıların gerekli olduğunu ve sürecin nasıl çalıştığını açıklar. Her projenin bir CONTRIBUTING dosyası olmasa da, varlığı bunun katkı bekleyen bir proje olduğunu işaret eder.
  • CODE_OF_CONDUCT: Davranış kuralları, katılımcıların davranışlarıyla ilgili temel kuralları belirler ve arkadaşça ve misafirperver bir ortamı oluşturmaya yardımcı olur. Her projenin bir CODE_OF_CONDUCT dosyası olmasa da, varlığı bu konuya dikkate edilen bir proje olduğunu gösterir.
  • Diğer belgeler: Özellikle büyük projelerde öğretici belgeler, izlenecek yollar veya yönetim politikaları gibi ek belgeler olabilir.

Son olarak, açık kaynak projeler tartışmaları yönetmek için aşağıdaki araçları kullanır. Arşivleri okumak, topluluğun nasıl düşündüğü ve çalıştığı hakkında size iyi bir fikir verecektir.

  • Sorun listesi: İnsanların projeyle ilgili sorunları tartıştıkları yerler.
  • PR (Değişiklik istekleri): İnsanların devam etmekte olan değişiklikleri tartıştıkları ve inceledikleri yerler.
  • Tartışma forumları veya e-posta listeleri: Bazı projeler, tartışma konuları için bu kanalları kullanabilir (örneğin, hata raporları veya özellik istekleri yerine “Nasıl …?” veya “Ne düşünüyorsunuz …?” gibi). Diğerleri, tüm konuşmalar için sorun listesini kullanır.
  • Anlık sohbet kanalları: Bazı projelerde gündelik konuşmalar, işbirlikleri ve hızlı fikir alışverişleri için sohbet kanalları (Slack veya IRC gibi) kullanılır.

Katkıda bulunacak bir proje bulma

Açık kaynak projelerin nasıl çalıştığını çözdüğünüze göre, katkıda bulunacak bir proje bulma zamanı!

Daha önce hiç bir açık kaynak projeye katkıda bulunmadıysanız, “Ülkenizin sizin için neler yapabileceğini değil, ülkeniz için neler yapabileceğinizi sorun” diyen ABD Başkanı John F. Kennedy’yi örnek alın.

Açık kaynağa katkıda bulunmak, farklı projelerde her seviyede gerçekleşir. İlk katkınızın tam olarak ne olacağını veya nasıl görüneceğini düşünmeniz gerekmez.

Bunun yerine, zaten kullandığınız veya kullanmak istediğiniz projeleri düşünerek başlayın. Aktif olarak katkıda bulunacağınız projeler, kendinizi devamlı kullanırken bulduğunuz projelerdir.

Bu projeler içinde, bir şeyin daha iyi veya farklı olabileceğini düşündüğünüzü farkettiğinizde, içgüdülerinize göre hareket edin.

Açık kaynak bir seçilmişler kulübü değildir; tıpkı senin gibi insanlar tarafından yapılmıştır. “Açık kaynak”, dünyadaki sorunların çözülebilir olarak algılanması için sadece süslü bir terimdir.

Bir README tarayabilir ve bozuk bir link ya da yazım hatası bulabilirsiniz. Ya da yeni bir kullanıcısınız ve bir şeylerin bozuk olduğunu ya da belgelerde gerçekten olması gerektiğini düşündüğünüz bir eksikliğin olduğunu fark ettiniz. Bunu görmezden gelip devam etmek ya da başka birinden düzeltmesini istemek yerine, araya girip düzeltebileceğinizi görün. Bakın açık kaynak budur!

Gündelik katkıların %28’i açık kaynağa yeniden biçimlendirme veya bir çeviri yazarken böyle bir yazım hatası düzeltme gibi belgelerdir.

Düzeltebileceğiniz açık sorunları arıyorsanız, her açık kaynak projenin başlayabileceğiniz acemi dostu sorunları vurgulayan bir /contribute sayfası vardır. GitHub’taki deponun ana sayfasına gidin ve URL’nin sonuna /contrib ekleyin (Örneğin https://github.com/facebook/react/contribute).

Yeni projeleri keşfetmenize ve katkıda bulunmanıza yardımcı olmak için aşağıdaki kaynaklardan birini de kullanabilirsiniz:

Katkıda bulunmadan önce üzerinden geçilebilecek bir kontrol listesi

Katkıda bulunmak istediğiniz bir proje bulduğunuzda, projenin katkıları kabul etmeye uygun olduğundan emin olmak için hızlı bir tarama yapın. Aksi takdirde, sıkı çalışmanız asla bir yanıt alamayabilirsiniz.

İşte bir projenin yeni katılımcılar için iyi olup olmadığını değerlendirmek için kullanışlı bir kontrol listesi.

Açık kaynak tanımını karşılar

Proje aktif olarak katkı kabul ediyor

Ana daldaki geliştirici faaliyetine bakın. GitHub’da, bu bilgiyi bir kütüphanenin ana sayfasında görebilirsiniz.

Ardından, projenin sorun listesine bakın.

Şimdi aynısını projenin PR listesi için yapın.

Proje katkı bekliyor mu?

Arkadaş canlısı ve misafirperver bir proje, yeni katılımcılara açık olacağını belirtir.

Nasıl katkı yapılır?

Hoşunuza giden bir proje buldunuz ve katkıda bulunmaya hazırsınız. En sonunda! İşte katkınızı doğru şekilde yapmanın yolu.

Etkili iletişim kurmak

İster bir kerelik bir katkı yapan, ister bir topluluğa katılmaya çalışan biri olun, başkalarıyla çalışmak açık kaynak dünyasında geliştireceğiniz en önemli becerilerden biridir.

Bir sorunu açmadan veya bir PR oluşturmadan ya da sohbette bir soru sormadan önce, fikirlerinizi etkili bir şekilde ortaya çıkarmak için bu noktaları aklınızda bulundurun.

Bağlam ver. Başkalarının sizi anlamada hızlanmalarına yardımcı olun. Bir hatayla karşılaşıyorsanız, ne yapmaya çalıştığınızı ve nasıl tekrarlanabileceğini açıklayın. Yeni bir fikir önerecekseniz, neden projeye faydalı olacağını düşündüğünüzü açıklayın (sadece sizin için değil!).

😇 “Y yaptığımda X olmuyor”

😢 “X çalışmıyor! Lütfen düzeltin.”

Ödevini önceden yap. Bir şeyleri bilmemek normaldir, ama denediğini göster. Yardım istemeden önce, bir projenin README’sini, belgelerini, sorun listesini (açık veya kapalı), e-posta listesini kontrol ettiğinizden ve bir cevap için interneti aradığınızdan emin olun. Öğrenmeye çalıştığını gösterdiğin zaman insanlar takdir edeceklerdir.

😇 “X’in nasıl uygulanacağından emin değilim. Yardım belgelerini kontrol ettim ve herhangi bir yerde bulamadım.”

😢 “X nasıl yapılır?”

İstekleri kısa ve öz tutun. Bir e-posta göndermek gibi, ne kadar basit veya yararlı olursa olsun, her katkı başkasının incelemesini gerektirir. Birçok projenin, yardım için uygunların yapabileceklerinden daha fazla gelen talebi olur. Basit olun. Birinin size yardım edebilme şansını artıracaksınız.

😇 “Bir API öğretici belgesi yazmak istiyorum.”

😢 “Geçen gün otoyoldan aşağı iniyordum ve benzin için durdum ve sonra aklıma yapmamız gereken bir şey için inanılmaz bir fikir geldi, ama bunu açıklamadan önce sana göstereyim …“

Tüm iletişimi herkese açık tutun. Her ne kadar cazip olsa da, hassas bilgileri (güvenlik sorunu veya ciddi davranış ihlali gibi) paylaşmanız gerekmedikçe, geliştiricilere özel olarak ulaşmayın. Sohbeti herkese açık tuttuğunuzda, daha fazla kişi alış verişinizden öğrenebilir ve bundan faydalanabilir. Tartışmalar da kendi başlarına katkı sayılabilir.

😇 (yorum olarak) “@-maintainer Merhabalar! Bu PR’a nasıl devam edelim?”

😢 (bir e-posta olarak) “Hey, e-posta yüzünden sizi rahatsız ettiğim için özür dilerim, ancak PR’mi gözden geçirme şansınız olup olmadığını merak ediyordum”

Soru sormak sorun değil (ama sabırlı olun!). Herkes bir zamanlar projede yeniydi ve deneyimli katılımcıların bile yeni bir projeye bakarken hız kazanmaları gerekiyor. Aynı şekilde, uzun süredir devam edenler bile, projenin her bölümüne aşina değildir. Onlara size göstermelerini istediğiniz sabrı gösterin.

😇 “Bu hatayı incelediğiniz için teşekkür ederiz. Önerilerinizi takip ettim. İşte sonuç.”

😢 “Neden sorunumu çözemiyorsun? Bu senin projen değil mi?”

Topluluk kararlarına saygı gösterin. Fikirleriniz, toplumun öncelikleri veya vizyonundan farklı olabilir. Geri bildirim sunabilir veya fikrinizi sürdürmemeye karar verebilirler. Tartışmanız ve uzlaşı aramanız gerekirken, geliştiriciler kararınızla sizden daha uzun yaşamak zorundadır. Düşüncelerine katılmıyorsanız, her zaman kendi çatalınızla çalışabilir veya kendi projenizi başlatabilirsiniz.

😇 “Fikrimi destekleyemediğiniz için hayal kırıklığına uğradım, ancak bunun sadece kullanıcıların küçük bir bölümünü etkilediğini açıkladığınızdan, nedenini anlıyorum. Dinlediğiniz için teşekkürler.”

😢 “Neden fikrimi desteklemiyorsun? Bu kabul edilemez!”

Her şeyden önce, zarif olun. Açık kaynak dünyanın her yerinden ortak çalışanlardan oluşur. Bağlam diller, kültürler, coğrafyalar ve zaman dilimleri arasında kaybolur. Ek olarak, yazılı iletişim bir ton veya ruh halini iletmeyi zorlaştırır. Bu konuşmaların niyetlerinin iyi olduğunu düşünün. Bir fikre kibarca geri dönmek, daha fazla içerik istemek veya konumunuzu daha da netleştirmek iyi bir şey. İnterneti bulduğunuzdan daha iyi bir yer bırakmaya çalışın.

Bağlamı toparlama

Herhangi bir şey yapmadan önce, fikrinizin başka bir yerde tartışılmadığından emin olmak için hızlıca kontrol edin. Projenin README”sini, sorun (açık ve kapalı) listesini, e-posta listesini ve StackOverflow”u gözden geçirin. Her şeyi yapmak için zaman harcamak zorunda değilsiniz, ancak birkaç anahtar terim için hızlı arama yapmak çok fayda sağlar.

Fikrinizi başka bir yerde bulamazsanız, harekete geçmeye hazırsınız. Proje GitHub’taysa, muhtemelen bir sorun açarak veya PR oluşturarak iletişim kurarsınız:

  • Sorunlar bir konuşma veya tartışma başlatmak için iyi yerdir
  • PR bir çözüm üzerinde çalışmaya başlamak içindir
  • Daha hafif bir iletişim için açıklayıcı veya nasıl yapılır sorusu gibi, eğer varsa projenin Stack Overflow, IRC, Slack veya diğer sohbet kanallarından sormayı deneyin.

Bir sorun açmadan veya talepte bulunmadan önce, belirli bir şey eklemeniz gerekip gerekmediğini görmek için projenin katkıda bulunma belgelerini (genellikle CONTRIBUTING veya README dosyaları) kontrol edin. Örneğin, bir şablon izlemenizi istenebilir veya test ortamı kullanmanız gerekebilir.

Önemli bir katkı yapmak istiyorsanız, üzerinde çalışmadan önce sormanız gereken bir sorun açın. Projeyi bir süre izlemeniz yararlı olacaktır (GitHub’da, tüm konuşmalar size bildirilmek için “İzle”yi tıklayabilirsiniz) ve kabul edilmeyebilecek bir işe başlamadan önce topluluk üyelerini tanıyın.

Bir istek/sorun açmak

Genellikle aşağıdaki durumlarda bir sorun açmalısınız:

  • Çözemediğiniz bir hatayı bildirmek için
  • Üst düzey bir konuyu veya fikri tartışmak için (örneğin, topluluk, vizyon veya politikalar)
  • Yeni bir özellik veya başka bir proje fikri önermek için

Sorunlar üzerinde iletişim kurmak için ipuçları:

  • Başa çıkmak istediğiniz açık bir sorun görürseniz, konuyla ilgili insanlara çalıştığınızı bildirmek için yorum yapın. Bu şekilde, insanların aynı konu üzerinde gereksiz yere çalışması daha az olasıdır.
  • Eğer bir sorun bir süre önce açılmışsa, başka bir yerde ele alınması ya da zaten çözülmüş olması olasıdır, bu nedenle çalışmaya başlamadan önce durum hakkında onay almak için yorum yapın.
  • Bir sorunu açtıysanız ancak cevabı daha sonra kendi başınıza çözdüyseniz, durumu bildirmek için soruna yorum yapın, sonra sorunu kapatın. Bu sonucun belgelenmesi bile projeye bir katkıdır.

PR açma

Genellikle aşağıdaki durumlarda bir PR açmalısınız:

  • Önemsiz düzeltmeleri göndermek için (örneğin bir yazım hatası, bozuk bir bağlantı veya açık bir hata)
  • Bir konuda önceden sorulmuş veya daha önce konuşmuş olduğunuz bir katkı için çalışmaya başladığınızda

Bir PR, bitmiş işi temsil etmek zorunda değildir. PR’ı erkenden açmak genellikle daha iyidir, bu nedenle diğerleri ilerlemeniz hakkında fikir sahibi olabilir veya geribildirimde bulunabilir. Sadece konu satırında bir “WIP” (Çalışmakta Olan Çalışma) etiketi ile işaretlemeniz yeterlidir. Daha sonra her zaman daha fazla geliştirme ekleyebilirsiniz.

Proje GitHub’taysa, PR nasıl gönderilir:

  • Depoyu çatallayın ve yerel olarak klonlayın. Kendi yerelinize ana depoyu “upstream” olarak bağlayın. Sık sık “upstream” den yapılan değişiklikleri çekin, böylece güncel kalırsınız ve çekme isteğinizi gönderdiğinizde, birleştirme çakışmalarının olasılığı daha düşük olur. (Burada daha ayrıntılı talimatlara bakın.)
  • Düzenlemeleriniz için bir dal oluşturun .
  • PR’nızda ilgili sorunlara veya destekleyici belgelere atıfta bulunun (örneğin, “Closes #37”)
  • Değişiklikleriniz HTML/CSS”de farklılıklar içeriyorsa önceki ve sonraki ekran görüntülerini ekleyin. Görüntüleri PR gövdesine sürükleyip bırakarak yükleyebilirsiniz.
  • Değişikliklerinizi test edin! Varsa, testleriniz varsa test edin ve gerektiğinde yenilerini oluşturun. Testlerin olup olmadığı, değişikliklerin mevcut projeyi bozmadığından emin olun.
  • Projenin tarzına uygun şekilde katkıda bulunun. Bu koddaki girintileri, noktalı virgülleri veya yorumları kendi deponuzda olduğundan farklı bir şekilde kullanmak anlamına gelebilir, ancak bakıcının birleştirmesini, başkalarının gelecekte anlamasını ve sürdürmesini kolaylaştırır.

Bu ilk PR ise, @kentcdodds’ın bir örnek video eğitimi olarak oluşturduğu Bir PR Yap‘ı izleyin. Ayrıca, @Roshanjossey tarafından oluşturulan First Contributions deposunda çekme isteği yapmayı da deneyebilirsiniz.

Yaptığınız katkıyı gönderdikten sonra ne olur?

Başardınız! Açık kaynak dünyasına katkıda bulunduğunuz için tebrikler. Umarız yapacağınız katkıların ilkidir.

Katkınızı gönderdikten sonra, aşağıdakilerden biri olacaktır:

😭 Hiç bir cevap almazsınız.

Umarım bir katkı yapmadan önce projeyi faaliyet belirtileri açısından kontrol ettiniz. Ancak aktif bir projede bile, katkınızın yanıt alamaması olası.

Bir haftadan uzun bir süredir yanıt alamadıysanız, aynı konuya kibarca yorum yazmak, birinden inceleme istemek doğru olur. Katkınızı gözden geçirecek doğru kişinin adını biliyorsanız, bunları o konuya ekleyebilirsiniz (@).

Özel olarak o kişiye ulaşmaya çalışmayın; Açık iletişiminin açık kaynaklı projeler için hayati önem taşıdığını unutmayın.

Kibar hatırlatmanıza rağmen hala kimse cevap vermiyorsa, hiç kimsenin cevap vermemesi mümkündür. Harika bir duygu değil, ama bunun sizin cesaretinizi kırmasına izin vermeyin. Herkesin başına gelmiştir! Kontrolünüz dışında olabilecek kişisel durumlar da dahil olmak üzere, yanıt alamamanızın birçok olası nedeni olabilir. Başka bir proje ya da katkıda bulunmanın başka bir yolunu bulmaya çalışın. Eğer bir şey bulamıyorsanız, bu topluluk üyeleri size dönmeden ve cevap vermeden önce katkı yapmak için çok fazla zaman harcamamak için iyi bir nedendir.

🚧 Biri katkınızda değişiklik talep eder.

Katkınızda değişiklik yapmanızın istenmesi, fikrinizin kapsamı hakkında geribildirimde bulunulması veya kodunuzda değişiklik yapmanız istenmesi yaygındır.

Birisi değişiklik istediğinde, duyarlı olun. Katkınızı gözden geçirmek için zaman harcadılar. Bir PR açmak ve uzaklaşmak kötü bir durumdur. Nasıl değişiklik yapılacağını bilmiyorsanız, sorunu araştırın, daha sonra ihtiyacınız olursa yardım isteyin.

Artık sorun üzerinde çalışmak için zamanınız yoksa (örneğin, tartışma aylardır devam ediyorsa ve koşullarınız değiştiyse), ilgili kişilere yanıt beklememelerini bildirin. Başkası devralmaktan mutlu olabilir.

👎 Katkınız kabul edilmez.

Katkınız sonunda kabul edilebilir veya kabul edilmeyebilir. Umarım zaten çok fazla iş yapmamışsındır. Neden kabul edilmediğinden emin değilseniz, bakıcıdan geri bildirim ve açıklama istemek tamamen mantıklıdır. Ancak, sonuçta, bunun kendi kararları olduğundan saygı duymanız gerekir. Tartışma içine girmeyin ya da düşmanca davranmayın. Anlaşmazsanız her zaman kendi versiyonunuzla çalışmaya hazırsınız!

🎉 Katkınız kabul edilir.

Yaşasın! Açık kaynak dünyasına bir katkı yaptınız!

Başardınız!

İster açık kaynak dünyasına ilk katkıyı yapmış, ister katkıda bulunmak için yeni yollar arıyor olun, harekete geçmek için ilham aldığınızı umarız. Katkınız kabul edilmese bile, bir geliştirici size yardım etmek için çaba gösterdiğinde teşekkür etmeyi unutmayın. Açık kaynak, sizin gibi insanlar tarafından üretilir: bir sorun, bir PR, yorum ya da beşlik.