Document Crafting, Objectively

Richard A. O'Keefe ok at cs.otago.ac.nz
Mon Mar 11 00:05:23 UTC 2002


Hannes Hirzel <hirzel at spw.unizh.ch> wrote:
	I wonder why not more people are writing active essays. All the tools
	seem to be there in Squeak. Why we not use this possibility? 

Documentation.

Documentation.

DOCUMENTATION.

Open a browser, choose "Find Class" from the class category pane menu,
enter "Essay", accept it, and there is no response.  (Not even an
"Essay not found" notice.  Anyone like that?)

Type "active essay" into a Workspace, select it, and choose
"method sources with it".  Result:
		There are no
Methods containing 'active essay' (use shift for case-sensitive)
OK

[By the way, if you hold down shift and click OK, nothing happens.
 Apparently that's not what "use shift" meant.  Start again,
 holding down the shift key when selecting "method sources with it".
 One gets the same response as the first time, suggesting that this
 search was _not_ case sensitive.  So how/when DO you "use shift"
 here?  Anyone _like_ this interface?]

>From this, anyone could be forgiven for assuming that Squeak 3.0 does
not support active essays.

>From the "Welcome to..." window, click on http://ww.Squeak.org
What's with the "exploded cheese"?
(Scamper request:  View Source option, please.)  No mention of
active essays.  Over to "Features".  No mention of active essays.
Morphic Links.  No mention of active essays.

Anyone who's not on the Squeak mailing list and not taught be someone
who is would probably never hear about active essays.

As for me, I do know of them, have tried to download a couple, and
found they wouldn't work in my (unmodified) Squeak.

I've just spent about 3/4 hour on the Swiki trying to find out
"how do I write an active essay".  No luck so far, so I've given up (again).

	... Real content is often missing and hard to find. ...

Exactly so.

Heck, I'm keen to use BookMorphs instead of PowerPain but can I figure out
how?  Nope.

(Still waiting to hear whether Squeak 3.2 is ready for use on Solaris 2.8,
and if so, which version to use.)



More information about the Squeak-dev mailing list