Kod Paylaşımları - Ne Yaptığını Bilerek Kullanalım
 

Merhaba,

İşe yarayan bir kod görünce insan denemek istiyor. Fakat yalnızca kodu bırakınca hangi sorunu çözdüğü, nereye ekleneceği ve neye ihtiyaç duyduğu havada kalıyor. Paylaşım yaparken bunları da birkaç cümleyle anlatın ki deneyen kişi tahmin yürütmek zorunda kalmasın.

Kullandığınız dili, sürümü ve gerekiyorsa kütüphaneleri belirtin. Nasıl çalıştırıldığını, hangi dosyada kullanılacağını ve beklenen sonucu yazın. Bir örnek giriş ve çıktı çoğu zaman uzun açıklamadan daha çok iş görüyor. Henüz denemediğiniz bir kodsa bunu açıkça söyleyin.

Kodları ekran görüntüsü yerine forumun kod alanıyla paylaşın. Uzun bir projede ilgili kısmı gösterip kaynak bağlantısını verebilirsiniz. Başkasının çalışmasını kendiniz yazmış gibi sunmayın; sahibini ve kaynağını belirtin, paylaşım izni veya lisans şartı varsa ona uyun.

Dosya silen, veritabanında değişiklik yapan, dışarıya bağlantı kuran veya bilgi gönderen bir kodda bu davranışları saklamayın. Nerede ve ne amaçla kullanıldığını açıklayın. Gizli veri toplama, arka kapı, zararlı yazılım, crack veya keygen paylaşımının burada yeri yok.

Paylaşmadan önce şifreleri, erişim anahtarlarını, bağlantı bilgilerini ve gerçek kişilere ait verileri çıkarın. Örnek değer kullanın. Yardım isterken bütün yapılandırma dosyasını olduğu gibi bırakmak yerine gerekli kısmı temizleyip ekleyin.

Kodu kullanan kişi de özellikle dosya veya veritabanı işlemlerini doğrudan çalışan sisteminde denemesin. Önce ayrı bir deneme ortamında ne yaptığını görün. Hata bildirirken sürümü ve hatayı hangi adımda aldığınızı yazın; böylece konu sadece "çalışmadı" mesajlarıyla dolmaz.