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