Hi Jon, I agree with most of your comments. I have added them to the related issue. We'll try to fix as many things as possible before 1.1 launch:
"Improve the Wiki structure" http://restlet.tigris.org/issues/show_bug.cgi?id=380 Best regards, Jérôme Louvel -- Restlet ~ Founder and Lead developer ~ http://www.restlet.org Noelios Technologies ~ Co-founder ~ http://www.noelios.com -----Message d'origine----- De : Jonathan Hall [mailto:[EMAIL PROTECTED] Envoyé : vendredi 19 septembre 2008 16:29 À : [email protected] Objet : Re: bad experience with restlets Some thoughts on the docs. The wiki's menu is a mass of expanded links and most are todos with noway of knowing, without clicking every single one, that they have content. It is truly awful to navigate. Should developer notes really be kept on the wiki? eg http://wiki.restlet.org/docs_1.1/g1/43-restlet/124-restlet.html How about: Moving the restlet.org documentation to the wiki. Unpublishing/removing anything that does not have content. Removing all developer notes. Make the wiki nav start contracted. Expand the quickstart (15 mins) tutorials to cover a lot more common containers. Remove the need to register to comment, use a simpler technique to stop comment spam (jroller style?) Jon Rob Heittman wrote: > But I do think many people will find Restlet more approachable when > the documentation and examples catch up with the platform and reach a > certain level of polish. Especially people coming from the Spring > universe, which is so rich in these areas. > > On Fri, Sep 19, 2008 at 5:19 AM, Jerome Louvel > <[EMAIL PROTECTED] <mailto:[EMAIL PROTECTED]>> wrote: > > I wish I could have had a look at it earlier, but 3 days to fix it > is not that bad, isn't it? :-) >
