[Pharo-project] comments comments comments again

Stéphane Ducasse Stephane.Ducasse at inria.fr
Mon Feb 28 09:13:31 CET 2011


> Hi Stéph,
> 
>   why not implement a tool that takes a package, asks the user to
> identify the most important class comment, and the creates comments
> for all uncommented classes in the package that direct the user to the
> most important class comment?  The generated comment could use the
> squeak code hyperlink support so the user just has to double click in
> the generated comment to get to the new comment.  How about also
> including in the comment template a suggestion of what kind of
> entry-point documentation you'd like to see?

I think that it would give the impression that there are comments.
Here my point was: "let us think 1 s about what is the key information a user would need?
oh of course how to execute the configuration so that it loads"

So this line should not be that difficult to add


To load me, execute
	((Smalltalk globals at: #ConfigurationOfPharo) project version: #stable) load

Because I'm lost with latest, default, load ....

We should have tool to use class comments to raise their values.
I hope soon that we will have a SmalltalkDoc up and running.


Stef





More information about the Pharo-project mailing list