User Manual

Gary McGovern garywork at lineone.net
Thu Nov 22 04:52:57 UTC 2001


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