On May 14, 2007, at 8:50 PM, Sanjay Jaiswar wrote:

Hi,

Vincent, you asked me to discuss about this doc in the mailing list.

Thanks for discussing it here.

This doc concentrates on complete setup guide for a newbie user (admin). Once setup is done, provided the help links for admin & user. I haven't created any redundant pages. Wherever required, xwiki links are re-used. Moreover, there are few additional links provided.

I've reviewed your document. While it's nice, I would much prefer we use the documents we have already started for the same purpose. Let's review the content of your doc:

* Sections 1 to 4 correspond exactly to the content of http://www.xwiki.org/xwiki/bin/view/AdminGuide/Installation. If that page is missing stuff (I couldn't find any) then it needs to be improved. However I don't think it's going to be good for our readers to have 2 installation documents.

* Sections 5.1.* corresponds to the user guide in http://www.xwiki.org/xwiki/bin/view/UserGuide/

* Section 5.2 correspond to http://www.xwiki.org/xwiki/bin/view/AdminGuide/User+Management

Thus I don't think we should duplicate the same content. I'd rather we:

1) Have a document that explains how to navigate the site (a sitemap)

2) Improve the current document if they're missing stuff

WDYT?

Again, thanks a lot for stepping in!

-Vincent

This is the TOC of the doc.
1   Document Purpose
   2   Prerequisites
   2.1   Jdk
   2.2   Tomcat Installation
   2.3   Mysql
3   Database
   3.1   Create Database
4   Xwiki Installation
   4.1   Deploy Xwiki
   4.2   Default Wiki Xar
   4.3   Importing Xwiki Pages (Xar)
5   Xwiki Help
   5.1   User's Guide
   5.1.1   Video Tutorials
   5.1.2   Features
5.2   Admin Guide
   5.2.1   Create Groups
   5.2.2   Add Users To Group

Refer the attached doc.
http://www.xwiki.org/xwiki/bin/view/Sandbox/InstallDevGuide

Thanks,
Sanjay