[DOCS] Re: Documentation [was: Morphic tutorial]

Stephane Ducasse ducasse at iam.unibe.ch
Thu Feb 13 09:53:14 UTC 2003

Hi Hannes

So go. go. go.
But then you will have to plan a cleaning of what you are writing in a 
year from now.

I think that documentation is good but this is a rich syndrome. If we 
could pay 10 or 5 squeakers
to document the system while 10 would code (bad already because it 
would be better to use
the developers to write SUnit that the other could use to build 
documentation) this would be great. But now the resources are rare.

> We need for example a good explanation about MorphicEvent handling
> as outlined by Andreas Raab in another thread.

Excellent I kept it.

> Having a tutorial about using ProtoMorph for learning about Smalltalk
> reflection and learning about the Morph hierarchy is helpful as well.

I like the idea this is really interesting, It should be generalized to 
have a list of
classes (HandMorph, Events...).

>> Not sexy fancy supercool but the only way to get concrete scenario
>> of the system
>> in a reproduceable way and in sync with the system because even 
>> example
>> methods got obsolete.
> I agree that we need more unit tests as they provide an automatic
> mechanism
> to find out about inconsistences!

Not only that to share knowledge. Read the UUID tests and you will 
share with me the same
perception of UUIDs. Which is really good.

More information about the Squeak-dev mailing list