Kötü Belgeler Raydan Çıkmasına Linux mu?

Kötü Belgeler Raydan Çıkmasına Linux mu?

Bam teline dokundu sahiptir var Linux bloglarında devam eden konuşmanın hafta gibi bir konu önermek şey yok.

Tabii ki, tam olarak neler oldu bu yana geçen ayın ortasında. Konu? Belgeler. Not good dokümantasyon, içinizin - kötü tür. Tür Linux Today's Carla Schroder "Linux Bug # 1 çağırır."

Çünkü çok uygun dokümantasyon iş 'için topluluk feragat kolay,' "Schroder bir blog yazısı birkaç hafta önce başladı yapmak" İnternet ve Google (NASDAQ: GOOG) FOSS geliştirme Tembelliği etkinleştirin.

"Telling kullanıcı ve potansiyel katılımcılar Google, e-posta listeleri ve forumlarda kullanmak belgeler değil." Schroder ücret. "Bu az kullanıcıların sahip garanti bir yolu, mutsuz kullanıcıları, ve daha az katkıda."

En azından, kodlayıcıların "ne oluşturmak için tam bir komut başvuru oluşturmanız gerekir, diye ekledi.

"Bu doğru, tüm komutları seçenekleri ile iyi eski kafalı adam sayfası, mesajları, dosyaları ve hata kodları," diye açıkladı. "Bu diğer belgeleri yazarlar için üzerine inşa için harika bir temel ve iyi kod yazma eşit önem verilmelidir."

'It's Getting Worse'

Linux Bugün ve LXer, hem canlı bir tartışma sonrasında yere en kısa zamanda iyi Schroder ikinci taksit ekledi konu üzerinde 00000Linux Planet yer aldı var.

Sonra, sadece bu hafta, Linux Planet'in Zımpara Fletcher bir kullanıcının bakış açısı ile chimed.

Kötü belgeleri Linux holding back mi? Blogcular söylemek çok oldu.

"Ben sık sık bir Linux ile en büyük sorunlardan biri kolay, kolay anlaşılır mevcut belgeler eksikliği olduğunu söyledi sonra," Linux Bugün JG yazdı, mesela. "Ve getting it-tarih, eski docs ... dışı kötü. Yakın zamanda Linux üzerinde bir dokunmatik çalışan çalıştım ve cehennem geçti."

'What It's Uzmanları musunuz'

Aynı şekilde: "İşte büyük FOSS bir çok şey orada stuff, ama kimse bir zihin okuyucu veya kod Tanrı ile başa olması gerekir," LXer Doğum dinotrac yazdı. "Belge, çocuklar. BT uzmanları budur."

Bu konu aslında görünüyordu ziyade, Linux Kız blogosphere sokaklarında daha fazla içgörü için aldı daha büyük olduğu ortaya dönüyordu Algılama.

"Bilmiyorum neden herkes kodlayıcıların olmak büyük teknoloji yazarlar beklediğini," Chris Travers, kim LedgerSMB proje üzerinde çalışan bir Slashdot blogger, LinuxInsider söyledi. "Evet, bazı şeyler bu değil, ama bu tüm yazılım ile belgelenmiş durumda olmalıdır.

"Sanırım keşfetmek için ihtiyacınız olan tek bir şey düşünüyorum, ama, nasıl teknik yazma ekonomik açık kaynak ekonomide mümkün kılmaktır" Travers ekledi.

'They Don't Even' It okuyun

"Ben GOOD belgelerine ödenen been sadece zaman zaman wow yatırımcılara-com patlamasının," Slashdot blogger Barbara Hudson nokta sırasında kullanılacaktır idi LinuxInsider söyledi. "Patronlar bugünlerde iyi belgelere para tasarrufu için görünmüyor."

Bile, "ne zaman belge şey, onlar bile okumaz rağmen gerektiği kötüsü," Hudson ekledi.

Noktasında Case: "İki gün Complete 'Belgeleri - herşeyi - yaparak geçirdim Geçen yıl ve ihtiyacı kadar hazır olması için Perşembe' biz üzerinde çalışırken sistemin," diye açıkladı. Değer "123 sayfa, içeriği, dipnot, dizin, özeti masa, bütün bit."

O iş iki gün yapılan bir hafta değdi, Hudson, ama dikkat sonucu okuma var hiç.

"Neden?" Oh, çok büyük's, ' "diye anlattı.

'I kadar suçlu kimse olarak Else' I'm

"Belgeleri ile sorunu orijinal geliştirici ne belgeye bilmek," zor bir Montreal Slashdot blogger Gerhard Mack LinuxInsider söyledi danışmanı ve. "Hepimiz bunu gerek biliyorum, ama nasıl olmaksızın veya çok ayrıntılı seyrek ve yine yanlış şeyler kapsayan yazmak için asla bilemezsiniz.

"Since I've olarak bir başkası olarak guilty, gerçekten soruna bir çözüm yoksa," Mack ekledi.

"Ben sadece RTFM RTFM 'daha sonra yapılmalıdır bulmak için söylendi kaç kez bilmiyorum,'" Slashdot Blogger hairyfeet söyledi. "Eğer docs sonra bitmiş değildir yazılım ve bitmiş değildir serbest olmamalıdır."

Bu tür durumlarda "amatör saat gibi Linux görünmesini sağlamak," hairyfeet LinuxInsider söyledi. 'Hobisi of' "gün OS bitti. Folks sadece zaman ya da arzusu, bir işletim sisteminin iç işleyişini öğrenmek gerekmez."

'Be There Has Temel Bilgileri'

Nitekim yenilere "kaynak kodu okumak için beklenen olamaz," blogcu Robert Pogson kabul etti. "İşte burada herkes bulabilirsiniz temel bilgileri olmalıdır."

Biz kim olarak en iyi biz o belgeye kodu kullanabilirsiniz çözüm, Pogson, "eklenir."

Diğer bir deyişle, "biz geri terbiyeli, kullanışlı belgelerine yazarak vermek için diş ipi daha fazla kullanıcıya gerek," diye opined.

Pogson kendini "emekli olarak yazılı bir sürü yapmak planlıyor," dedi LinuxInsider söyledi.

Tüm FOSS Kullanıcılar Calling

"Bu yapılabilir: örnek, örnekler, örnekler," diye belirtti. "Ne zaman çok fazla seçenekleri, parametreleri ve komutları vardır, örnekler çoğu kişi ve kullanım temiz olur ihtiyaç durumları gürültü kesti."

Büyük GUI uygulamalar için ise, "ekran büyük olması," Pogson ekledi. "Bir resim bin kelime değer."

Duydun mu, sevgili okuyucular? Bu silah için bir çağrı's - ya da daha doğrusu, klavye için bir çağrı. Dokümantasyon başlasın!