Hi
I concur on the documentation problem.
I concur that there is plenty of documentation, but finding it is a chore.
I have two side projects I have started.
Doc at
http://www.squeaksource.com/@FICALqrUmxQTIHgr/ul4_-exC
And SeasideDoc (which I started before Doc)
http://www.squeaksource.com/@FICALqrUmxQTIHgr/zwF3AJHcI expect that I will develop Doc completely before refactoring SeasideDoc to sit on top of it.
The core ideas are:
1. That documentation should be available in-image in familiar terms--by sending messages to "stuff"
2. The documentation should be VERY EASY to add to (unlike the HelpBrowser, which ,imho, is coding, not documenting).
3. StackExchange style commenting with upvotes, priority.
4. Doc saves to a normal repository squeaksource or however pharo does its stuff, and hence, evolves with the image.
5. ?? this one is a stickler. should documentation be tightly bound with the Objects per Class comment style? or should it exist symbiotically? I think the latter. If so, what is the best design pattern(s) to facilitate that.
Regarding 1. ......
by sending messages to "stuff"
stuff is..
classes: Dictionary doc
packages: PG3 doc
frameworks: Seaside doc
XTreams doc
Design Patterns: Singleton doc
Facade doc
BigBallOfMud doc (j.k.)
I think typical Gnu-Linux style "man" , "help" , "info" or "verbose" would be an incredibly useful tool in bridging the "how do I do foo" gap that Squeak certaintly has and I suspect Pharo does too.
I am very busy with a PEG grammar development project, so this is back burner stuff for me.
I post this in the hope that some guru will take over the project and make Pharo/Squeak/ (and other) Smalltalks the BEST documented systems on the internet.
Cheers.
tty