16 May
2007
16 May
'07
2:32 p.m.
Hi Sanjay,
First let me start by saying I'm really happy you took the time to
contribute content to xwiki.org. We definitely need people to jump in
and help us document XWiki.
See below.
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