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 _______________________________________________ Mono-docs-list maillist - Mono-docs-list@lists.ximian.com http://lists.ximian.com/mailman/listinfo/mono-docs-list