[Mono-docs-list] First draft of the new Version of Use is finished.

Valentin Sawadski valentin.sawadski at gmx.de
Fri May 25 10:39:53 EDT 2007


Hello again,

On Monday 21 May 2007 19:17, Adrien Dessemond wrote:
> On Mon, 2007-21-05 at 12:00 -0400,
>
> Wow, nice job (not easy to try to structure a documentation) ! Your
> suggestion gave me an idea. I still have to work on it when it will be
> ready I will make a proposal here.

Oh very thanks! :-)

>
> Here is my opinion for the current "New" template :
>
> 1. "Getting Mono" : I would remove this, you already have another "entry
> point" for that (the "Download now" link is the most natural one that
> will be used). The "use" section, in my book, must be solely dedicated
> to product use aspects.

That figures. Removed it.

> 2. The logic behind the sections ordering should follow a kind of
> "natural order" : first you want to know what Mono is and this is the
> goal of the "start" section, next you download it, next you want to see
> it in action on your machine or want to start writing your own
> (Web)apps/with it, next you want to deploy your applications and so on.
> As you develop your application, you might want to refer to the API or
> to some stuff like whitepapers or Howtos/samples as Miguel suggested. Do
> you see my reasoning ?

I intended to follow this "natural order" because if you want to use something 
you have to get if first right? Therefore I wanted to have a crash-course for 
how to get Mono but since the download link is perfectly visible it is more 
natural for users to go there.

> What disturbs me in my idea is that the support section is the kind of
> stuff people love to see at the first glance. So it definitely has to be
> obviously visible. May its current location in your template is the best
> option. I do not have something better to propose for it for the moment.

Probably I do. But that seems to a topic of it's own so I'll start a new 
thread for it.

> 3. [Your work is still a draft proposal, I do not know if your idea was
> to go on that way] : I would remove the "Resource" frame since it, IMHO,
> messes up the section. Its contents could be put somewhere else like
> being merged in some way in the grey menu or put through the different
> paragraphs.

Thank god I'm not the only one who does not like that green box :-D
(Just left it there because it was there in the original version).

Kind Regards,
Valentin Sawadski


More information about the Mono-docs-list mailing list