On Mar 1, 2010, at 11:08 AM, Thomas Mortagne wrote: Actually it's meant to be a full User Guide to replace the current page at http://enterprise.xwiki.org/xwiki/bin/view/UserGuide/ (the existing Getting Started guide would disappear). Basically the idea is to have a single user guide that starts with some basic feature explanations (the getting started part) and that increases in complexity as you progress through the guide. Thanks -Vincent

Hi Vincent, Thanks for the feedback On 3/1/2010 12:17 PM, vmassol [via XWiki] wrote: I think the collection of links makes it easier for users to spot the documentation they are interested in. I agree that Guillaume's Getting Started guide needs to be reintegrated in the user guide as much as possible. As a consequence I've added links to part of the pages. Other issues however, like managing user groups, are better described in the platform documentation (more information, screenshots), so I preferred adding a link to those resources instead. If the Getting Started pages will be removed altogether I can copy their content to different pages and set the User Guide as their parent. I'll also include more screenshots. I added the TOC at the "XWiki Basics" level, but this can easily be changed. My initial idea was for the guide to provide links to part of the documentation. This would be the pages that are most necessary when starting with XWiki and that don't require programming or advanced admin skills to understand. (Hence "This is not a TOC for all the documentation, but rather a selection of links to help you get started with XWiki." in the first email). I've extended the invitation for users to visit the Developer & Administrator's Guides to further their skills and get a deeper understanding of XWiki. This way "Getting started" is interpreted not necessarily as the first steps to take with XWiki, but rather as mastering the basics of working with XWiki, with the possibility of enhancing your skills as you read the rest of the documentation. Should we add links to all our existing resources I think the User Guide may get too crowded and users with no significant coding experience may have trouble understanding it. WDYT? The idea behind the User Guide page was that of a TOC (this is why it looks more like a collection of links). The small pieces of text are there to put the links in context, so that they make sense when seeing them for the first time. I agree with the having more separate pages. While in some sections the existing documentation is enough, for other areas we could add a lot more details to make things clear. This is the case of the blog for example (which is not yet included) for which there will be a separate guide. After the blog guide is ready there will be of course a link to it from the User Guide. The same goes for the WYSIWYG editor. This can be also done for other sections if users consider the existing documentation is not clear/descriptive enough. I think we should avoid having images on the User Guide's main page (the one in Drafts) since this page's role is that of a TOC. I agree with having many screenshots in the sub-guides (e.g. the blog and wysiwyg guides, the new pages resulting from the old "Getting Started" guide) This is obviously a work in progress, as it entails creating many child pages and changing the current main draft, however feedback early on in the process is appreciated so the final result answers most of our first time user's basic questions. Thanks ----- Silvia Rusu Tester & Documentation Writer - XWiki http://twitter.com/silviarusu -- View this message in context: http://n2.nabble.com/Proposal-Improving-the-User-Guide-documentation-tp4653… Sent from the XWiki- Users mailing list archive at Nabble.com.

Hi, After reading all your emails I think the best solution is having both a guide for first time users and a complete guide to all XWiki features: - The Getting Started page can become the draft included in this email - The User Guide could be a TOC of all existing resources as Vincent suggested. This way both experienced and unexperienced users are happy: - First time users can discover XWiki one step at a time with the help of the "Getting Started" page - Experienced users don't have to look for information through the different wikis and can instead go to the User Guide TOC. Smaller guides will be made as suggested in the previous email for the blog, wysiwyg, etc. These will be linked from both the Getting Started page and the User Guide. WDYT? ----- Silvia Rusu Tester & Documentation Writer - XWiki http://twitter.com/silviarusu -- View this message in context: http://n2.nabble.com/Proposal-Improving-the-User-Guide-documentation-tp4653… Sent from the XWiki- Users mailing list archive at Nabble.com.

Please somedbody of the long term addicts should write a book about XWiki. All important projects do have books and for many people the availbility of printed literature marks the difference between some open source project and an important open source project. Before picking up a new software and spending much time with learning and practicing many people check amazon for the availability of literature. +1 for better Online documentation +10 for a decent book covering all levels from beginner to developer Andreas Caleb James DeLisle schrieb: