Açık kaynak kodlu bir projeye başlamak için kontrol listesi [kapalı]


50

Açık kaynak kodlu bir projeye başlamak, sadece kaynak kodunu bazı kamu depolarına atmak ve bundan memnun olmamaktır. Teknik (kullanıcı dışında) belgeleriniz, nasıl katkıda bulunacağınız hakkında bilgi vb.

Yapılacak önemli şeyler için bir kontrol listesi oluşturursanız, buna ne eklersiniz?


1
+1 Güzel Soru. Ben tavsiye edebilir: gawande.com/the-checklist-manifesto
JeffO

2
Karl Fogel'in (orijinal yıkım yazarlarından biri) kitabı Açık Kaynak Kodlu Yazılım Üretme kitabının , başarılı bir özgür yazılım projesinin nasıl çalıştırılacağını öneriyorum .
Michael,

Açık Kaynak Kodlu Yazılımın Karl Fogel tarafından üretilmesi size bu konuda yardımcı olmalıdır. Kitap tamamen çevrimiçi olarak mevcuttur.
Coyote21

Yanıtlar:


34

En önemli şey:

  • Projeyi kendiniz kullanın ve kullanmaktan zevk alacağınız faydalı bir duruma getirin. Projenin çalıştığından ve yararlı olduğundan emin olun.

Erken önceliklere koyduğum şeyler:

  • basit bir "o nedir?" bazı tartışma forumlarına (e-posta veya sohbet) ve kaynak kod deposuna bağlantılar içeren web sitesi
  • Kodun derlendiğinden ve genellikle çalıştığından, devam eden iş ya da ana dalda işleri kıran yarı kıçlı yamalar yapmadığından emin olun, çünkü o zaman diğer insanların işleri bozulur
  • iyi bilinen bir lisansla kod havuzuna bir lisans dosyası yerleştirin ve telif hakkı sahibini (muhtemelen siz veya şirketiniz) işaretleyin. lisansı atlamayın, bir lisans oluşturmayın veya belirsiz bir lisans kullanmayın.
  • katkıda bulunma, HACKING dosyasında söyleme veya README'inize ekleme konusunda talimatlara sahip olmak. Bu, nereye yama gönderileceğini, yamalar nasıl biçimlendirileceğini, kod girme kurallarını, projenin diğer önemli sözleşmelerini içermelidir.
  • bir hatayı nasıl rapor edeceğinize ilişkin talimatlara sahip olmak
  • posta listesinde veya forumlarınızda ne olursa olsun yardımcı olun

Bu önceliklerden sonra derdim ki:

  • dokümantasyon (bu sizi posta listesinden kurtarır ... liste mesajlarınızdan bir SSS yapmak basit bir başlangıçtır)
  • işleri "normal" bir şekilde yapmaya çalışın (kendi derleme sisteminizi icat etmeyin veya garip bir tane kullanmayın, 1 boşluk girintisi kullanmayın, genel olarak sinir bozucu davranmayın çünkü öğrenme eğrisi ekler)
  • Projenizi tanıtın. pazarlama pazarlama. Sizi korumak için bazı bloglara ve haber sitelerine ve benzeri şeylere ihtiyacınız var ve ardından insanlar ilgilendiğinde, onlarla konuşmanız ve çalışıp çalışmadıklarından emin olmaları gerekir. Belki projenizi ilgili projeler için forumlarda belirtin.
  • yamaları her zaman mümkün olduğunca çabuk gözden geçirin ve kabul edin. Hemen mükemmel. Birkaç günden fazla bir süredir, birçok insanı kaybediyorsunuz.
  • Proje hakkındaki e-postaya her zaman mümkün olan en kısa sürede yanıt verin.
  • karşılama / olumlu / eğlenceli bir atmosfer yaratın. salak olma. lütfen söyle ve teşekkür et ve övgü dağıt. toplanıp toplumu zehirlemeye başlayan tüm katliamları kovala. Bağlar kurabildiğiniz zaman şahsen tanışmaya çalışın.

Peki ya potansiyel yasal problemler? Kişi, uygulamanın istemeden patentli bir algoritma içermediğinden nasıl emin olabilir?
Den

Bunu tespit etmek ne yazık ki mümkün değil. Bir kod grubu göz önüne alındığında, ilgili patent (ler) in yerini bulmak için hangi arama terimlerinin gerektiğini bilmenin bir yolu yoktur, bu nedenle yazılım patentlerinin böyle bir sorun olmasının bir nedeni vardır. Bazen de geçerlidir patent olduğunu biliyorum, ama orada emin olmak için bir yol duymadım değil geçerlidir patent. Negatif olduğunu kanıtlamak zor. Patentler, muhtemelen kendi soruları olması gereken yeterince büyük bir konudur ...
Havoc P

17

Yeni başlayanlar için, Bariyeri girişte indirin , bunun anlamı:

  • Kurulumu kolaylaştırmak,
  • değiştirmeyi kolaylaştırmak,
  • Projenizi bulmayı kolaylaştırmak,
  • sadece yapmak istediğiniz her şeyi kolaylaştırın.

Nasıl?

  • Dokümantasyonunuzda aklınıza gelebilecek her soruya cevap verin,
  • Kullanımı kolay bir derleme sistemi oluşturun,
  • Kodunu temizle, kimse spagetti kodunda çalışmayı sevmiyor,
  • İnsanların ihtiyaç duyduğu bir şey yapın.
Sitemizi kullandığınızda şunları okuyup anladığınızı kabul etmiş olursunuz: Çerez Politikası ve Gizlilik Politikası.
Licensed under cc by-sa 3.0 with attribution required.