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