Internet Info, s.r.o. Lupa Měšec Podnikatel Root Zdroják DigiZone Slunečnice Vitalia TopDrive KupDnes Navrcholu NovýTarif Dobrý web Weblogy Woko Jagg Computer.cz SK: MojeLinky

Hlavní navigace

Názor k článku
Komiks: Mistr a učedník

Martin Mareš
27. 5. 2006 21:35

Re: Problem je v lidech co rikaj RTFM

celé vlákno
To je bezpochyby zajímavá psychologická teorie, ale já dám raději na praxi. Pokud se porozhlédnu po uživatelích okolo sebe (tím nemyslím ani tak naši alma mater, jako spíš přispěvatele všelijakých mailing-listů), nemohu si nepovšimnout, že značná část dotazů jasně ukazuje, že si v dokumentaci tazatel nepřečetl ani první odstavec, případně že mu naprosto uniká kontext (ptá se na ovládání nějaké síťové utility, aniž by znal základy fungování TCP/IP). Na takovou stěnu můžeš naházet hrachu kolik chceš a stejně, potvora, nedrží. V takových případech je hloupost vylepšovat hrách a RTFM je odpověď zcela zasloužená a pro dotyčného přínosná, i když pravý guru by jej samozřejmě spíš přetáhnul holí, aby se mu rozsvítilo :-)

Po profilu typického vývojáře se nemá smysl ptát, dopadne to dost podobně, jako ptát se na profil typického uživatele této planety, tj. tak, že slabší povahy se po poznání odpovědi leknou a utečou a silnější se občas raději stanou poustevníky. Ono napsat dobrý program s dobrou dokumentací není snadné a lidí takovým uměním nadaných je na světě nemnoho, takže většina programů je nutně mizerná. To ale není specialita softwarového světa -- například na sazbě knížek je to vidět úplně stejně: od té doby, co je může na počítači tisknout kdekdo, je většina knih vysázena mizerně. Ale práce opravdových sazečských mistrů se i dnes občas potkává.

Jak je to obecně, nemohu soudit, ale o vývoji kernelu něco málo vím. Je tam dobře vidět, že většina lidí okolo free SW dělá to, co je nejvíce baví, což je typicky také to, co nejlépe dovedou. A většina programátorů zkrátka daleko lépe programuje než píše dokumentaci, zvláště když se jedná o dokumentaci, kterou oni sami nepotřebují (naproti tomu třeba lockovací pravidla v kernelovém VFS jsou zdokumentována velmi důkladně, protože je to nutné). Ale ani u kernelu není situace nikterak katastrofální: třeba manuálové stránky syscallů jsou napsané a udržované docela dobře, o vnitřní architektuře jádra vycházejí i knížky (třeba velice pěkné Linux Device Drivers, k dispozici jak papírově, tak online). Určitě to může být lepší (zvláště autoři některých driverů jsou na slovo skoupí), ale nestěžuji si.

V mnoha případech je to prostě tak, že lidé free SW vyvíjejí hlavně sobě pro radost a teprve na druhém místě je všeobecné blaho světa. Pokud jim dokumentace nechybí, nejsou nikomu zavázáni ji psát. Pokud Tobě chybí, pak to nejlepší, co můžeš udělat, je přestat psychologovat a místo toho přiložit ruku k dílu. Maintaineři takřka všech programů patche do dokumentace vítají s otevřenou náručí.