Nemám rád ukecané uživatele (diskuse)

[VícNežNic]

Nejslavnější román tohoto autora je pozorhodný zejména svoji formou, je totiž celý sepsán formou hlášení chyby v počítačovém programu a děj je následně rozvíjen v komentářích, což je rovněž způsob jakým jsou krátkými vstupy začleněny další postavy. Autor se postupně od jednoduchého problému s kódováním dostává k závažným otázkám mezinárodního porozumění a vyvozuje překvapivé závěry. Vše je prostoupeno čistě technickými pojmy, kde se autor snaží přiblížit své dílo i obvyklým čtenářům této formy literárních děl. Jeho styl je zejména popisný, často se obrací ke čtenáři a snaží se ho zatáhnout do děje. Nešetří detaily, pokládá si otázky a předkládá na ně odpovědi.

Hlavní myšlenkou díla je poznání, že napíšeme-li příliš dlouhý komentář, nebude to po nás nikdo číst.

Můj názor? Arab…

[Michal Čihař]

Nene, hlavní poznání je, že stačí číst dokumentaci .

[xkesh]

Vida, konecne nekdo kdo cte bugreporty a vi, co ho v nich stve a mohl by tedy sepsat male HOWTO, jak spravne hlasit bug (treba na priklade bugzilly abicka). Do FAQ jako delane :)

[Michal Čihař]

Z googlu mi vypadlo třeba tohle.

[xkesh]

Jasne (BTW to byl navrh bez ironie), ale tohle je navod, jak chybu popsat. Chtelo by to doplnit o konkretni ukazky ovladani bugzilly - kdyz se tam nejaky uzivatel odhodla, vybafne na nej spousta okynek a rubrik. Co je dulezite a co ne? Co znamenaji ty udaje u jednotlivych bugu... atd. Rek bych, ze by to tu proslo i jako clanek.

[Michal Čihař]

Ale tohle je pro každý bug tracking systém jiné…

[unchallenger]

Ten návod i vysvětlení samozřejmě jsou v dokumentaci bugzilly. Jenže tam je to asi každému málo.

[xkesh]

Ten návod i vysvětlení samozřejmě jsou v dokumentaci bugzilly. Jenže tam je to asi každému málo.

Tyka se prakticky vsech HOWTO a skoro vsech navodu. Malo z nich se zabyva nezdokumentovanymi funkcemi - jsou tedy zbytecne? Krome toho, kdyz budu chtit nahlasit chybu nejakeho programu, tak nemam naladu zacit hledat a zkoumat nejakou dokumentaci. Najit abicko a FAQ je podstatne rychlejsi ...

Kdyz nastartuji napr. bugzillu abclinuxu, tak tam zadne vysvetleni nikde neni.

[Michal Čihař]

Není?

Before reporting a bug, please read the bug writing guidelines

[xkesh]

Ano ano ano ano... jenomze az pomerne hluboko (tedy tesne pred zadanim), coz potencialni ohlasovatele moc nepovzbudi. Ja preci nevolam, aby to bylo v bugzille nekde driv, ale spis navrhuji clanek jako jsou clanky JAK NA LILO (byt je v LILO dokumentaci take vsechno popsano). Z nejakych duvodu si myslim, ze by to nejlepe asi mel sepsat nekdo, kdo takove bugreporty pravidelne cte a muze pridat svoje osobni poznamky. To je vse pratele :)

[Michal Kubeček]

Tyka se prakticky vsech HOWTO a skoro vsech navodu. Malo z nich se zabyva nezdokumentovanymi funkcemi

Uff. Vždycky jsem si myslel, že nedokumentované funkci se tak říká právě proto, že není popsána v dokumentaci… :-)

[Robert Krátký]

Dokumentace a článek mají obojí něco do sebe. V ideálním případě je to článek, který uživatele zbaví strachu potýkat se s programem, a nasměruje ho na správnou dokumentaci. Kdybychom se řídili tím, že budeme psát jen o tom, o čem není nic v dokumentaci, moc článků by nevycházelo. Přesto věřím, že jsou články přínosem.

[unchallenger]

7kB dlouhý bugreport je OK za předpokladu, že alespoň 6kB je backtrace...

[Michal Čihař]

No u PHP není v silách běžného uživatele udělat backtrace . Tady to jsou jenom kecy.