kilon alios wrote

> Pharo has zero official reference documentation

Well Pharo By Example and Deep into Pharo are close. IMHO, we've chosen to
pour as many of our limited resources as possible into shrinking and
redesigning the system into something one person can master, rather than
thoroughly document things that may soon change drastically or disappear.
Real BDD (Behavior Driven Design i.e. tests from the perspective of the user
of the library) would help here as the tests would provide documentation for
free. But BDD doesn't seem to have caught on in the Smalltalk world, and I
find many (most?) tests to be useless from a "how does this library work"
perspective. Also, when the system stabilizes and we start documentation
"for real", the fun part will be active essays; traditional paper-like
documentation is the kind of thing Smalltalk was invented to replace.



-----
Cheers,
Sean
--
View this message in context: http://forum.world.st/Where-is-the-postcard-with-syntax-tp4763281p4764026.html
Sent from the Pharo Smalltalk Developers mailing list archive at Nabble.com.