Let's suppose I'm a first visitor reading this page:

http://code.google.com/p/pharo/wiki/Downloads?tm=2

" ... A link is given below to get the image ... "
There are various links below, specifically what is that link? (Suggestion:
anchor the link word)

" ... You can either upgrade your image ... "
Any hint or link explaining how?

" ... The virtual machine may be downloaded from ... "
Suggestion:
" ... The virtual machine [for the X Operating System] may be downloaded
from ... " and then
"The virtual machine [for the Y Operating System] may be downloaded from ...
"

" ... The lastest VM available ... "
" ... The latest VM available ... " (typo)

" Pharo files are still hosted at the Pharo INRIA project site. "
>From an user point of view I don't know why that would be relevant.

" Please head over to http://gforge.inria.fr/frs/?group_id=1299 "
To get the image ? the image and VM ? to choose downloading options ?
(what I mean is that isn't clear the "image" reference at the beggining of
page refers to this link or the "specific files" link below).

" Here are some links to specific files:
Pharo Core: Pharo0.1Core-10204.zip "
Suggestion:
" If you want to do/have/use X, you can download Pharo Core... "
" If you want to do/have/use Y, you can download Pharo Developer... "
etc.

Final notes:
-There is no "Installation instructions" guidelines or link, this commonly
is: "When download is completed, uncompress.... get a mysterious .sources
file, and then copy the .exe there......"
-Still remain assumptions for a first visitor, like he already knows what is
an image, a virtual machine. Many first visitors are outsiders and they
download first, read later (show me don't tell me). My suggestion is to
provide a link/page in key words "image", "virtual machine", I guess there
are many sites where this is explained easily; and a reference link, to the
SqueakByExample book for example, for people who wants to read more.
Just a couple of suggestions.

Cheers

Hernán
_______________________________________________
Pharo-project mailing list
[email protected]
http://lists.gforge.inria.fr/cgi-bin/mailman/listinfo/pharo-project

Reply via email to