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? :-)
