🚀 go-pugleaf

Jacek Konieczny wrote:
> In article <asj3mu$hil$1@news.tpi.pl>, Lucifer wrote:
> 
>>Może to tak zabrzmiało.. cóż ;) Dokumentacji nie polecam 
> 
> A ja wręcz przeciwnie.

Tak.. jasne, ze ta dokumentacja jest potrzebna, z tym, ze w wiekszosci 
jest generowana ze źródeł, brakuje przykladow, klasy sa beznadziejnie 
opisane. Obrabiac XMLa nauczylem sie ze slajdow i notatek jakiegos 
francuza, bo w dokumentacji nie pisza jak tego uzywac.

>>(szczególnie tej z python.org) bo jest zazwyczaj beznadziejna
> 
> IMHO jest bardzo dobra. Mało jaki projekt Open Source (zresztą
> komercyjny też) ma taką dobrą dokumentacje. Do tego dochodzą mechanizmy
> autodokumentacji i jest po prostu super.

Brak przykladow (sa jakies, ale powinno byc znacznie wiecej), z opisu 
funkcji, metody trudno czasem wywnioskowac jakiego typu maja byc argumenty.

>>, wiecej sie mozna dowiedziec czytajac zrodla.
> 
> Zależy co ktoś chce wiedzieć. Do normalnego korzystania z języka
> dokumentacja wystarcza. A używanie nieudokumentowanych cech języka jest
> po prostu proszeniem się o kłopoty i to nie tylko w przypadku Pythona.

Nie mowie o tym, jak zajrze do zrodel to widze dokumentacje (w 
potrojnych cudzyslowach) i kod funkcji/strukture klasy.

-- 
Lucifer