I completely understand the inability to create full blown documentation
because of lack of free time. I am not referring to any Pharo Library out
there.
Please  pharo developers comment your classes.

Dont even comment the small ones, comment the big ones (over 20 methods). 5
minutes per class , is 150 words (assuming you are a slow 30 words/per
minute , 3 times more if you type fast). Just a class comment, I can live
without method comments. 15 lines, enough to provide valuable information
to your users.

Even for very big libraries like Spec it should not take more than 10 key
classes to be documented this way , no more than 1 hour total of
documentation for a project that can take months of coding to complete. It
can't be this hard.

Saying that I will start adding class comments wherever I can but obviously
the people that have created the code are far more qualified than me .

Have a nice day :)

Reply via email to