User Manual

Gary McGovern garywork at lineone.net
Sat Nov 24 18:18:42 UTC 2001


Aha! Learning Squeak is like playing a game such as Tomb Raider. There are
many obstacles, red-herrings and dead ends on the path that must be resolved
to reach the inner sanctum of Object-Oriented wisdom. ;o)))))

Regards,
Gary


----- Original Message -----
From: "Gary McGovern" <garywork at lineone.net>
To: <squeak-dev at lists.squeakfoundation.org>
Sent: Thursday, November 22, 2001 4:52 AM
Subject: Re: User Manual


> The site is perfectly alright in IE 5.5.  Very nicely done, but I agree
with
> Richard that the blue text should be a different colour so as not to look
> like links.
>
> From: "John Hinsley" <jhinsley at telinco.co.uk>
>
> > I just wondered whether a better place for this might be Minnow: it
> > would allow others to chip in with examples and might be easier to
> > maintain (or even produce) than a .html (sorry, in your case .htm)
> > version?
>
> I was thinking something "similar". I was thinking of a collection of 5
wiki
> pages entitled "Squeak School". Each page would be a class or a grade. But
> the pages wouldn't contain the lessons, just urls and book titles and
> ISBNs.Main theme would be for each page to be "a grade"/"ladder" that
takes
> you up to the next one. Just to put a bit order into all the resources.
>
> E.g. 1st Grade
> Getting your feet wet with tutorials and playing with projects.
> 2nd Grade
> Learning the Smalltalk Language.
>
> And so on
>
> Regards,
> Gary
>
>
> ----- Original Message -----
> From: "Richard A. O'Keefe" <ok at atlas.otago.ac.nz>
> To: <squeak-dev at lists.squeakfoundation.org>
> Sent: Wednesday, November 21, 2001 10:29 PM
> Subject: Re: User Manual
>
>
> > Maarten Maartensz wrote:
> > > The first part first version is done, and a html-version of it can be
> seen
> > > on my site as:
> > >
> > >
>
http://www.xs4all.nl/~maartens/log_comp/User_Manual_part1_version0_in_html.h
> tm
> >
> > So I fired up Netscape, gave it the URL, and saw
> >
> >     "What you're seeing now is a window with this text inside a
> >      larger window."
> > False.
> >     "The window this text in has a title - Introduction to Everything
> >      in the User Manual ..."
> > False.  The displayed title is "Netscape: Welcome to the Computing#
> > Pages of Maarten Maartenzs" where # is a funny looking thing that I
> > first took for a hollow ^C but turns out to be &nbsp;.
> >     "resized by dragging the sides of the window"
> > False.  If I drag on the sides of the window, the window moves.
> > And so on, and so on.
> >
> > It appears that the author assumed that you would read this in Scamper,
> > but at least on the first screen, nowhere says so.
> >
> > The very first page in this manual SHOULD say that the manual is meant
> > to be viewed with Scamper, and SHOULD say how to do that.
> >
> > I note that the actual HTML markup is unusually well-formed for
something
> > made using FrontPage, but makes extremely heavy use of <font color...>,
> > which is regrettable.  The colours don't show up at all in one of my
> > browsers, and some of them look exactly like links in another, which
makes
> > it *most* confusing to read.  I kept clicking on things that LOOKED like
> > links but weren't.
> >
> >
> >
> >
>
>
>
>





More information about the Squeak-dev mailing list