Vlákno názorů k článku
Komiks: Mistr a učedník
Problem je v lidech co rikaj RTFM
Bohuzel Linux a podobne free software projekty zadnou slusnou dokumentaci nemaji, a ani ji mit nemuzou, protoze vyvojari mi sami na kernel mailing listu sami odepsali, ze si to nepreji, protoze "to stoji cas".
Ja na Ronje takovy problem nema - kdyz lidem neco z instrukci neni jasny, tak to beru jako chybu instrukci a opravim to tam.
Vysledek je takovy, ze to chodi na prvni pokus i lidem, kteri v zivote zadnou elektroniku nestavili.
Coz o Linuxu se rict neda, je to presne naopak - pouzivam ho vylucne a nepretrzite asi 11 let, takze zadny novacek nejsem, a stejne mi to vetsinou nechodi ani na kdovikolikaty pokus.
Napriklad posledne ALSA - asi 3 dny jsem se s tim moril, aby chodil korektne dmix, a nakonec nechodil, protoze v ALSA byla buga (podle jejich bugtrackeru).
Casto vyvojari taky alibisticky napisou dokumentaci a nehnou ani prstem pro to aby byla prehledna, takze vysledek je dokumentace neprehledna, ktera je k nicemu - k cemu je cloveku ze v dokumentaci je informace, kdyz nevi, jak se k ni dostat (na ktery link kliknout nebo ktere klicove slovo vyhledat).
Psychologicky profil typickeho vyvojare free SW je dle meho nazoru zakomplexovany asocialni autista, ktery si mysli, ze je reditelem zemekoule. Jeho schopnosti v oboru psychologie, marketing, ergonomie a dokumentace jsou 0. Slovy: nula.
Tohle je treba zmenit - vyvojari musi adresovat tento problem stejne jako adresuji technicke problemy v software - analyzovat a odstranit pricinu. Jenze k tomu se nejdriv musi zbavit emocni zavislosti na svem vlastnim egu. K tomu je dle meho nazoru idealni buddhismus, ktery propaguje Johanka.
Re: Problem je v lidech co rikaj RTFM
Tohle sedi na me --- az na to, ze nejsem autista, ale schizoidni psychopat. Schopnosti v jinych oborech nemam.
Re: Problem je v lidech co rikaj RTFM
Ale jinak ten zbytek to jo, to je fakt. A vzhledem k tomu ze ses totalni psychopat tak si ani nemyslim, ze to hodlas zmenit :)
Re: Problem je v lidech co rikaj RTFM
Re: Problem je v lidech co rikaj RTFM
Scrollování kolečkem skáče takže člověk ztratí řádku co čte. V Linksu je to plynulé takže se řádka neztratí, a navíc se dá číst i během scrollování.
Re: Problem je v lidech co rikaj RTFM
Rovněž všelijakých scrollovacích udělátek existuje do Firefoxe přehršel, takže každému, co jeho jest. Ergonomie je pěkná věc, ale dost často konverguje k poznání, že různým lidem vyhovuje různé ovládání. (Opět příklad z vlastní zkušenosti: někteří programátoři například čtou rychleji syntax-highlighted zdrojáky, někteří zase neobarvené.)
Re: Problem je v lidech co rikaj RTFM
souhlas na 100% - to je prave pekne na linuxu/unixu, ze je hodne veci konfigurovatelnych ... ja jsem treba nikdy nepotreboval ve VIM-u jiny styl editace dlouhych radku, nez default (logicky radek je na vic fyzickych radkach a sipky up/down skaci po logickych radcich), ale kdyz se vyskytla potreba udelat to tak, aby to skakalo po fyzickych, tak jsem zjistil, ze to nejenom lze, ale dokonce to lze pohodlne namapovat i na sipky ...
kazdemu vyhovuje neco jineho a kazdy si to, co mu vyhovuje, muze zapnout/nastavit ... freedom
Re: Problem je v lidech co rikaj RTFM
Re: Problem je v lidech co rikaj RTFM
Re: Problem je v lidech co rikaj RTFM
Re: Problem je v lidech co rikaj RTFM
Re: Problem je v lidech co rikaj RTFM
Re: Problem je v lidech co rikaj RTFM
Osobně je mi jedno, jakej co používá scrolling, protože pokud někde něco potřebuje Xka, či jiný grafický prasečiny, jsem maximálně nasranej už v tom momentě, kdy to spustím, takže skákající scrolling mě už víc nasrat nemůže, v textmodu je to myslím úplně jedno.
Re: Problem je v lidech co rikaj RTFM
Re: Problem je v lidech co rikaj RTFM
Re: Problem je v lidech co rikaj RTFM
Re: Problem je v lidech co rikaj RTFM
na druhe strane 90% lidi neni ochotna si precist ani zakladni informace a tak bude spamovat vase ICQ/MSN/mail a budou chtit presne ty informace ktere jsou popsane v manualu velkym pismem a hned na zacatku. a jsou i takovi, kterym napisete presne to co chteli slyset a oni na to jestli by jim to clovek mohl zopakovat, ze to nechapou.
vysledny efekt : dela to presne co by melo, ale nema to cenu vysvetlovat
Re: Problem je v lidech co rikaj RTFM
Ono je to taky zpusobeny tim ze 90% manualu jsou crap takze ty uzivatele jsou uz nacviceny ze se tam ani neobtezujou kouknout. Ja se jim nedivim - ja to delam taky tak.
Re: Problem je v lidech co rikaj RTFM
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čí.
Re: Problem je v lidech co rikaj RTFM
Samozrejme ze existuju BFU ktorym unika kontext, vobec nie su ochotni citat manual atd.atd. Ale ak napises program s totalne chybajucim (v extremnom pripade neodpoveda ani len na --help) alebo matucim (ako napriklad gtkpod - tiez bez akejkolvek dokumentacie) rozhranim tak si budes v komunikacii s nimi zbytocne nicit nervy a ostatni slusni pouzivatelia si mozu pomysliet "no toto asi napisal zas nejaky k...t" a ak nebudu musiet tak sa ti ani vobec neozvu.
Na F/OSS komunite su mne odpudivi prave ti ludia ktori uvolnia program pod GNU GPL a potom sa bavia na tom ako nejaky blby pouzivatel zasa nieco nezbadal, nepochopil a ze ako ho najlepsie "poucit". Ked uz raz chces zdielat svoju pracu tak to rob poriadne, nie? Ospravedlnovat sa ze vecsina programatorov daleko lepsie programuje nez pise dokumentaciu je cisty alibizmus a zastieranie vlastnej neschopnosti. Ked si taky super uzasny programator tak to urob tak jednoduche aby manual nebolo treba, nie? Nehovorim teraz o vyvoji jadra (ale aj tam mi vzdy pride vhod mat dopredu napisane v normalnej reci ako co funguje).
Mne tiez viac vyhovuje plynule skrolovanie ale nevykrikujem ze je to najlepsi mozny sposob. Ci najdem za 200ms to co hladam zavisi od toho ci je OBSAH toho co citam napisany dostatocne prehladne. <flame>Myslim si ze programatori co nie su schopni dostatocne prehladne vyjadrit funkciu programu pomocou GUI alebo napisanim prehladneho manualu nie su schopni ani napisat prehladny kod.</flame>
Re: Problem je v lidech co rikaj RTFM
Ked uz raz chces zdielat svoju pracu tak to rob poriadne, nie?
Právě že tak free software nefunguje. Lépe řečeno jsou ho dva druhy -- jeden autoři píší pro ostatní a dávají si obvykle záležet i na dokumentaci, zatímco ten druhý si napsali sami pro sebe a řekli si, že i když je to třeba narychlo splácaný hack, přesto by se mohl někomu hodit, a tak ho místo do šuplíku hodí na nějaké veřejně přístupné místo. Někdy taková věc zapadá prachem, jindy se z ní časem vyvine životaschopný projekt, jindy si ostatní takový program spletou se softwarem onoho prvního druhu a autorovi nadávají, že k tomu nenapsal dokumentaci.
Zkrátka spoléhat na to, že cokoliv publikovaného je kvalitní, je příznak naivity, nikoliv špatnosti světa.
Re: Problem je v lidech co rikaj RTFM
Treba aby sa autor zamyslel ze napriklad ci naozaj ma vyznam az tak premenlive kontextove menu, ze musis kliknut na nejake uplne miniaturne gizmo v grafe a az potom sa ti tam objavi funkcia ktoru potrebujes... Hlavne ze on sa citi ako uber programator ze nieco take vyrobil.
Re: Problem je v lidech co rikaj RTFM
Na ovládání a dokumentaci většiny programů je samozřejmě pořád co vylepšovat, spíš mne zaráží s jakou jistotou tady mnozí rozebírají, jak se programátoři cítí jako mistři světa :-) Ono je to často spíš tak, že po napsání velkého programu se cítíte dočista maličkatí, protože vidíte, že to je teprve začátek a že za každým řádkem se schovává hromada věcí, které by ještě stály za vylepšení.
(Osobní zkušenost: programátoři, kteří se cítí jako mistři světa, většinou píší spíš shareware pro wokýnka, vždyť co by se zahazovali s nějakým free SW... :) )
Re: Problem je v lidech co rikaj RTFM
Takže až si někdo objedná Ronju a místo 6.8 odporů mu přijdou 6.8k a bude muset bugreportovat na Ronje a objednávat znova a znova platit dobírku, tak ať ví koho za to nakopat do prdele - vývojáře OpenOffice :)
Re: Problem je v lidech co rikaj RTFM
Re: Problem je v lidech co rikaj RTFM
Ale OO.org jsou normální uživatelský program a měl by počítat s tím, že typický uživatel je naprostý idiot. Já když dělám web, tak předpokládám, že uživatel neví, co je internetová adresa. Autoři OO.org by IMHO měli předpokládat, že uživatel nedokáže číst (protože on to skutečně nedokáže - je líný to na konci znovu přečíst)...
(Ve skutečnosti se mi to automatické doplňování, které tu pravděpodobně způsobilo chybu, v OO.org líbí, ale nemůže to fungovat, pokud bude ten program používat typický Windowsácký uživatel.)
Re: Problem je v lidech co rikaj RTFM
> znovu přečíst)
Pokud po sobe uzivatel neprecte co napsal, tak je to debil, bez ohledu jestli to pise v OO, M$O, T602 nebo treba ne mechanickem psacim stroji. Bejt sefem (coz nastesti nejsem :-), tak takoveho zamestnance kopnu do prdele ...
Re: Problem je v lidech co rikaj RTFM
No ano. Takovi lide skutecne v prumeru jsou. Co z toho ma plynout? Vyhladit 70% lidstva?
> bez ohledu jestli to pise v OO, M$O, T602
Ne, MSO nemaji takove nebezpecne featury jako bleskove doplnovani.
> Bejt sefem (coz nastesti nejsem :-), tak takoveho zamestnance kopnu do prdele ...
Whatever...
Re: Problem je v lidech co rikaj RTFM
Ona dokumentace není všechno (a dokumentace k Ronji je taky...zajimavá). Může mi třeba někdo vysvětlit, co to je za šílenost v podobě U1,U2,U3 v Transmitteru Ronja 10M Metropolis? To je tam jako proto, aby to bylo složitější, nebo proč? To by nešlo udělat _jedním_ rychlým FETem?
Re: Problem je v lidech co rikaj RTFM
http://ronja.twibright.com/satisfying.php
Ono když programátor se mohl programovat, tak se může naučit taky psát dokumentaci. Já jsem se to na Ronje musil taky učit. Ze začátku to bylo vysoce nekvalitní.
Re: Problem je v lidech co rikaj RTFM
Nejsem příznivce nějaké veliké byro-specifikace, ale u každé funkce, kterou mohou používat drivery, by se aspoň mělo napsat blokuje/neblokuje, může se volat z procesu/interruptu/timeru/softirq, může/musí/nesmí být drženy tyto locky. A pokud se tyto podmínky změní, tak nejlépe změnit název funkce, aby se drivery, co ji používají, neslinkovaly. Pokud jako vývojář driveru naleznu v jádře funkci, která se blokuje, pokud dostane argument třeba "3", nijak z toho kódu nepoznám, jestli je to blokování součást implementace (později ji můžou vývojáři přepsat, aby se blokovala za jiných podmínek) nebo jestli je to součástí architektury a je zaručeno, že se ve všech budoucích verzích bude blokovat pouze s tímto parametrem.
Re: Problem je v lidech co rikaj RTFM
Re: Problem je v lidech co rikaj RTFM
Re: Problem je v lidech co rikaj RTFM
U velkých projektů znám asi jen jedinou výjimku (zato pořádnou :)), a to je páně Knuthův TeX.
Re: Problem je v lidech co rikaj RTFM
Re: Problem je v lidech co rikaj RTFM
Problém je právě v tom že ty lidi vyvíjej Linux pro radost sobě a ne ostatním. Navruhuju aby začli vyvíjet pro radost ostatním. Ona tam ta radost pro sebe pak vznikne jako vedlejší efekt. Aspoň tak to funguje u Ronji. A taky tak to hlásá Dalajlama a Johanka :)
Ono "přiložení ruky k dílu nefunguje" - např. u Ekiga jsem našel, že jim chybí prerequisita v instalačních instrukcích. Tak jsem jim to poslal a oni řekli že to odmítaj s tim že můj Linux je špatně nainstalovaný. Můj Linux byl nainstalovaný a ta buga v návodu Ekigy je pořád.
To si radši opravím dokumentaci od Ronji. Tam mě s tím nikdo nevyfuckovává. Posledně jsem strávil neuvěřitelného času na psaní testovacích procedur a teď už je to mnohem přehlednější než bývalo :)
Re: Problem je v lidech co rikaj RTFM
Navruhuju aby začli vyvíjet pro radost ostatním.
S tím nemohu než souhlasit, ale je hloupost takové názory ostatním vnucovat, to nikdy v historii nefungovalo a není důvod, proč by to mělo fungovat zrovna teď :-)
Tak jsem jim to poslal a oni řekli že to odmítaj s tim že můj Linux je špatně nainstalovaný.
Ale no tak, přeci se nevzdáš hned :-) Každou chvíli posílám patche na nějaké drobnosti a v naprosté většině případů je autoři buďto přijmou nebo chybu opraví po svém. A když je odmítají, většinou z dobrých důvodů.
Možná je to tak, že ke každému je svět takový, jaký ho čeká :-)
Napsat dobry program s dobrou dokumentaci je snadne
Já si myslím že to není pravda. Jednoduchý algoritmus k napsání dobrého programu s dobrou dokumentací:
1) Zadefinujte projekt jako satisfying project
2) vemte první bugreport který reportuje diskrepanci se satisfying productem, pokud nejsou bugreporty, tak
feature report. Pokud nejsou feature reporty, nějakou novou featuru si vymyslete
3) analyzujte bugreport a zjistěte příčinu bugy. V případě feature reportu vymyslete jak to implementovat
4) odstraňte bugu / přidejte featuru bez ohledu na to jestli to vyžaduje drobnou změnu nebo napsání programu znova from scratch
5) goto (2)
Tento algoritmus je jednoduchý a nevyžaduje znalosti ani zkušenosti - dají se doplnit on the fly z wikipedie a mamma.com.
Použil jsem ho na Ronje. Fungoval i přesto, že jsem ze začátku nevěděl ani jak funguje tranzistor (první zesilovač pro Ronju se choval opravdu legračně).
Re: Napsat dobry program s dobrou dokumentaci je snadne
To, co popisuješ, je dobrá iterační metoda, jak ještě zlepšit projekt, který už je docela dobrý. A mnoho projektů se ještě do tohoto iteračního stadia nedostalo, případně dostalo, ale jelikož množství energie ve vesmíru je omezené, iterují pomalu. Ale i tehdy je dobré projekt zveřejnit, například proto, že někdo další může přiložit ruku k dílu. Byť nejlépe s tučným varováním, aby se z nepochopení stavu projektu nestalo další topivo pod ohníček těch, kdož rádi nadávají na špatnost světa :-)
Re: Napsat dobry program s dobrou dokumentaci je snadne
"Ale i tehdy je dobré projekt zveřejnit" - já nepíšu že se to nemá zveřejňovat. Ty iterace může provádět i široká veřejnost na zveřejněném projektu.
Tyhle diskuse fakt nemaj cenu - jsou 2 druhy lidí. Jedni chápou co znamená "program slouží uživateli ke spokojenosti", a druhý to prostě nechápou, ať se jim to vysvětluje sebelíp.
Já si myslim že to nechápou protože oni jsou líný a tak maj podvědomě takové pochopení zablokované, aby se nedohalilo, že musej měnit svuj přístup a nedejbože něco nového se učit nebo se nedejbože přizpůsobit reálnému stavu věcí.
Já už se s lidma na Linuxu ani nehádám - radší píšu patche do projektů kde jsou lidi rozumní, jako např. do programu na tištěné spoje PCB jsem poslal už nejmíň 3 patche.
Re: Napsat dobry program s dobrou dokumentaci je snadne
Re: Napsat dobry program s dobrou dokumentaci je snadne
Re: Problem je v lidech co rikaj RTFM
Pokud vyvojar dela dany open source projekt zadarmo, budme radi, z tomu tak je, a on nema zadny duvod psat dokumentaci, kdyz nechce. Skutecne to stoji cas a existuji prijemnejsi zpusby, jak jej stravit, nez opetovne sezeni za pocitacem, zvlast kdyz uz takhle tento programator stravil dost casu nad projektem samotnym. Zejmena kdyz vubec neni asocialni. Myslenka, ze kdo neni altruista, je svine, je temer politicky nazor. Navic pomerne hodne nebezpecny politicky nazor.
Pokud je open source vyvojar placen, zalezi ciste na subjektu, ktery jej plati. Takovy vyvojar je obvykle pomerne drahy a neni jich mnoho. Dokumentaci tedy tvori jenom ve velmi omezene a zcela nezbytne forme (viz zminene zamykani ve VFS, snad jediny soubor v dokumentaci kernelu, ktery je aktualni). Pokud se ti to nelibi, muzes se stat zakaznikem danych spolecnosti a spolu s podobnymi uzivateli je primet to zmenit.
S tim nema nic spolecneho to, ze na ruznych forech se objevuji ruzni sasci vyjadrujici ostentativni pohrdani mene zkusenymi uzvateli.
Ano open source ma velike problemy s dokumentaci. Na tom ale neni nic divneho. Zvlast u obrovskych a velmi "zivych" projektu jako je kernel, gcc, KDE, kde jakekoliv psani dokumentace je z podstaty veci strelba na bezici terc.

