On Mon, Dec 13, 2010 at 02:34:58AM +0100, Torsten Bergmann wrote: > > If you want to follow this "class to book" approach then HelpSystem > provides a class > called "CustomHelp" that you can subclass and that has all the necessary > support > (even for editing and saving by using a workspace) - so you can easily > implement your > help books. Some projects use this already and there is even a Pharocast > on how to > to this.
FWIW, I recently put the old Squeak Terse Guide into a subclass of CustomHelp. For me, I was just trying to find a way to make the Terse Guide easily available, and after messing around with loading it into a workspace, it suddenly (d'oh!) occurred to me that I could just load it as a help book, so that is what I did. The important thing for me is that I found class CustomHelp, and that is what I used. It worked fine, so now we have the Terse Guide in a help book. I don't know if this is the ultimate best help system to end all help systems, and I'm all in favor of a pragma based approach, but I have to say that any documentation system that actually gets used is better than even the most perfect documentation system that does not get used, so my hat is off to Torsten for providing a simple, accessible, and usable help system. Dave p.s. You can load the terse guide for Pharo from http://source.squeak.org/Trunk package Help-Squeak-TerseGuide
