Hi All,

Stefan Ducasse replied to me regarding my synapsis of the CMakeVMaker code.

Igor created all the logic of the CMakeGenerator but I guess that he did not add good class comments so I thought that it would be great if you can
add the comment to a class so that it is not lost. Information external to classes is often lost.

And I agree with him.

In Linux/Open Source world, are the conventions of README and HOWTO. I propose that Squeak adopt two class categories for developers to add easy access to documentation on subsystems in the README category and quick howto_foo_a_bar classes in the HOWTO category.

I know we have the web, and there is a Help system, but I find the Help system a bit clunky to use and breaking from Squeak environment to Web for information breaks the flow.

A recent example of where this proposal would come in handy is the recent discussion about reviving Tweak for Squeak 4.5/4.6. The time investment to get up to speed is vastly increased by having to hunt for information.

just my .02

cheers.

tty