pořádná dokumentace (alespoň veřejného api) prostě musí být
Jenze v C++ je problem, ze tou objektovosti je toho verejneho API (funkci/metod/cehokoli co je verejne pristupne k volani odjinud) je nekolikanasobne vic. A je ho vic o triviality, ne o realnou funkcnost. Podle me z nazvu funkce by uz melo byt jasne co funkce dela. Dokumentace "API" je potreba jen v pripade, ze _nad to_ ta funkce ma nejake speciality (mozna ty vyjimky, ja bych treba rekl pozadavky na externi zamykani, atd.).
K velikosti "API" v C++ jeste prispiva to, ze pokud chcete mit neco naprogramovane "ciste" (pekne), tak je neco jineho aby "objekt mel ciste (zejmena ortogonalne) navrzene rozhrani" a je neco jineho, co realne potrebuje uzivatel toho objektu. Coz je to co jsem psal driv - ze proste v C++ k te tride dopisete "kompletni" rozhrani (pekne ciste navrzene, o tom zadna), akorat je ho mnohokrat vic a casto ne presne takove, jako potrebuji uzivatele toho objektu.
-Yenya
