Açık kaynağa kod dışı katkılar

Kod dışı katkılar açık kaynak başarısının anahtarı

• Matematik öğretmeni Sarah Rainsberger, gönüllü olarak açık kaynak katkıcısı olmayı özellikle hedeflememişti; ancak koro web sitesini yeniden kurarken JavaScript ve web geliştirmeyi öğrenmeye başladı.
• Frontend framework'ü Astro'yu kullanırken projeye yapılandırma dosyası gibi küçük bir kod parçası katkısında bulundu; topluluğa katılarak yeni Astro kullanıcılarını destekleme rolünü üstlendi.
• Rainsberger şu anda Astro'nun çekirdek bakımcı grubunun bir üyesi, ancak kod tabanına yoğun biçimde dahil olmak yerine ağırlıklı olarak dokümantasyon üzerinde çalışıyor ve başkalarının Astro'yu öğrenmesine yardımcı oluyor.

Açık kaynak projelerde önemli kod dışı işler

• Açık kaynak projelerde kod yazmanın yanı sıra dokümantasyon, yerelleştirme, pazarlama, grafik tasarım, test, topluluk yönetimi ve sürüm yönetimi gibi işlere de ihtiyaç vardır.
• Kod dışı katkıların önemi çok büyüktür; proje ne kadar karmaşıksa, kodu faydalı kılmak için o kadar fazla dokümantasyon, eğitim içeriği ve desteğe ihtiyaç duyulur.
• Grafik tasarım, marka oluşturma ve outreach, bir projenin sağlıklı ve ciddi olduğunu gösteren sinyaller olarak işlev görür; bu da başka projelerin veya şirketlerin onu bir bağımlılık olarak kullanabilmesini sağlar.

Neden kod dışı katkılara başlamalısınız?

• Kod dışı katkılar, teknik iletişim, grafik tasarım ve kullanıcı deneyimi tasarımı gibi programlama içermeyen rollere ilgi duyan kişiler için portföy oluşturma fırsatı sunar.
• Programcılar da yazma ve iletişim becerilerini geliştirmekten fayda görür; bu da developer relations veya ürün yönetimi gibi rollere geçişe yardımcı olabilir.
• Açık kaynak projelerde her beceri seviyesinden insanın katkı sunma fırsatı vardır ve projeyi derinlemesine anlamadan anlamlı kod katkıları yapmak zordur.

Kod dışı katkıcılar bulmak ve teşekkür etmek

• Bakımcılar için katkıcı bulmanın en iyi yolu, belirli görevleri açıkça istemektir; topluluk oluşturmak ve "yardım aranıyor" ile "ilk iş için uygun" etiketli issue'lar açmak da faydalıdır.
• Mentorluk, katkıcıları başarıya ulaştırmanın en iyi yollarından biridir; kod dışı katkıcıları değerli görmek ve takdir etmek, mevcut katkıcıları motive etmeye ve yeni katkıcıları çekmeye yardımcı olur.

GN⁺ görüşü

• Açık kaynak projelerin başarısının, yalnızca kod yazmanın ötesinde çeşitli katkılar gerektirmesi önemli bir noktadır. Bu, projenin sürdürülebilirliği ve büyümesi için temel bir unsurdur.
• Kod dışı katkılar, teknik olmayan kişilere de açık kaynağa katılma fırsatı sunar ve teknik yetkinliklerin geliştirilmesine de yardımcı olur.
• Bu yazı, açık kaynak topluluğuyla ilgilenen kişilere ilham verebilir ve kendi becerilerini kullanarak topluluğa nasıl katkı sağlayabileceklerini bulmalarına yardımcı olabilir.

[secret3056]

Biraz farklı bir konu ama kısa süre önce birisi Express.js’in README dosyasına PR göndermeyi ders olarak paylaştı ve bunun üzerine yüzlerce anlamsız PR açıldı.

Pull requests · expressjs/express

[mdisprgm]

Başa bela.. hıçkırık

[edunga1]

100'den fazla PR varmış, vay be, vay canına

[sagee]

"Barcode" ile nasıl katılındığı konusunda kısa bir kafa karışıklığı oldu ama.. :)
Ayrıntılı dokümantasyon da bir bakıma iki ucu keskin bir kılıç olabilir.
Belgeler ve ekran görüntüleri geliştiricinin taşımakta zorlanacağı kadar ayrıntılı hale geldiğinde, dokümanları güncellemeye cesaret edemediği için iyileştirme geliştirmelerinden vazgeçilen durumlar da ortaya çıkabilir..

[cosine20]

("Kod dışı" koddur)

[GN⁺]

Hacker News görüşleri

• Küçük ölçekli bir kütüphanenin yazarı/yöneticisi olarak, dış katkılar olmasaydı kılavuzun bugün olduğu kadar iyi olmayacağını doğruluyor. Kılavuz, projenin kullanılabilirliğine büyük katkı sağlıyor.

  • libcurl'ün yeni bir kullanıcısı olarak, öğretici ve API belgeleri sayesinde FTP yüklemeyi hızlıca hayata geçirip bunu belirli kullanım senaryolarına göre uyarlayabildi.
  • Belgeler sayesinde eski sürümlerde thread safety eksikliğini fark edip ekibi güncelleme yapmaları konusunda uyarabildi.
  • Dokümantasyon, kod ve test paketi kadar önemli.

• Açık kaynak projeler için istekler:

  • bol miktarda ekran görüntüsü
  • çok uzun ve ayrıntılı bir README.md
  • öğreticiler, referans belgeleri, tasarım belgeleri, mimari diyagramlar
  • yazarın nasıl düşündüğünü açıklayan zihinsel model belgeleri

• Dokümantasyon, varlıklar vb. açık kaynakta önemli, ancak geliştirici olmayanlara güç vererek projeyi bozabilir.

  • Her sürümde UX'i yeniden yapmak gibi davranışlarla istikrar, işlevsellik ve benimsenmeye zarar verebilir.
  • Politikaya çok ilgi duyan insanları çekebilir ve herkesin yapabileceğini düşündüğü alanlarda bikeshedding yaşanması kolaydır.

• Topluluk oluşturmak için Discord, Gitter, Slack gibi sohbet platformlarını kullanmanın iyi olduğu söyleniyor.

  • İnsanların depoda soru sormaktan çekinmemesini sağlar.
  • GitHub'da soru sormak ya da bir sorunu çözen pull request oluşturmak çoğu zaman anlamsız derecede ağır hissettirir.
  • GitHub proje oluşturucuları arasında "kodu açık ettim, bunun ötesinde kimseye bir borcum yok" tavrı yaygın.

• WordPress topluluğunda etkin olma deneyimine dayanarak, erken dönemdeki dokümantasyonun ve Codex'in güçlü belgelerinin WordPress'in büyümesine büyük katkı sağladığı düşünülüyor.

  • Joomla, Drupal ve WordPress'in kurulu taban açısından benzer olduğu dönemde, WordPress zengin dokümantasyonu sayesinde başlaması daha kolaydı.

• Açık kaynak projeler için en büyük dilek, insanların onu kullanması ve kullandıkları şey hakkında bir şekilde iz bırakması.

  • Projenin Discord kanalına mesaj bırakmak, tweet, kısa mesaj, ekran görüntüsü, gist, herkese açık GitHub deposu, YouTube veya TikTok videosu gibi şeylerin hepsi proje için çok değerli katkılardır.

• Kod dışı katkıların bir projenin başarısının gizli formülü olup olmadığı net değil, ancak çok önemli olduğu konusunda hemfikir.

  • Örneğin Eclipse Foundation, hata raporlarının da değerli bir katkı olduğunu kullanıcılara hatırlatıyor.

• Açık kaynak proje başlatma sürecinde, gerçekten kod yazacak mühendislerden 10 kat fazla mühendisin yazılımı kullanacağı öngörülüyor.

  • Kullanıcıların dokümantasyonu iyileştirerek katkıda bulunabilmesi gerekir.
  • Hugo gibi statik site oluşturucularla dokümantasyon (kullanıcı kılavuzu) üretilirken, kullanıcıların GitHub issue oluşturmadan dokümantasyona düzeltme/güncelleme gönderebilmesinin bir yolu gerekli.

• Teknik olmayan insanların projeyi anlayıp onda değer bulması, projenin başarılı olacağına dair iyi bir göstergedir.

• Ürünün henüz bilinmediği, hayranlar tarafından kullanıldığı aşamadan daha fazla kullanıcı bulma aşamasına geçerken dokümantasyon önemlidir.

  • İyi dokümantasyon olmadan bu aşamayı geçmek zordur.
  • Neural Amp Modeller için bir kullanıcı kılavuzu yazılması gerektiğini hatırlatıyor.