Return-Path: Delivered-To: apmail-maven-dev-archive@maven.apache.org Received: (qmail 76752 invoked by uid 500); 6 Jun 2003 11:32:58 -0000 Mailing-List: contact dev-help@maven.apache.org; run by ezmlm Precedence: bulk List-Unsubscribe: List-Subscribe: List-Help: List-Post: List-Id: "Maven Developers List" Reply-To: "Maven Developers List" Delivered-To: mailing list dev@maven.apache.org Received: (qmail 76736 invoked from network); 6 Jun 2003 11:32:57 -0000 Received: from guardian.cqs.ch (193.247.212.100) by daedalus.apache.org with SMTP; 6 Jun 2003 11:32:57 -0000 Received: by guardian.cqs.ch with Internet Mail Service (5.5.2650.21) id ; Fri, 6 Jun 2003 13:31:48 +0200 Message-ID: <43D0784A8EA7044FA945A39DDF01CEDC06A2F0@guardian.cqs.ch> From: Michal Maczka To: 'Maven Developers List' Subject: RE: Maven web site and Wiki Date: Fri, 6 Jun 2003 13:30:47 +0200 MIME-Version: 1.0 X-Mailer: Internet Mail Service (5.5.2650.21) Content-Type: text/plain X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N If we can make it happen it will be great. Anything to improve documentation is a change in good direction (as long as can be controlled)! +1 Michal -----Original Message----- From: Vincent Massol [mailto:vmassol@pivolis.com] Sent: Friday, June 06, 2003 1:01 PM To: 'Maven Developers List' Subject: Maven web site and Wiki Hi, Here are some facts: - Our Maven web site contains lots of inaccuracies and would not suffer from additional documentation - Some Maven users would be happy to contribute if we gave them easy tools for that. The idea: - Transform our web site from a static web site into a Wiki web site. - But not any wiki! One that saves topics in XML format. For example the MoinMoin wiki saves topic in xdocs format (stylebook style unfortunately but that's not too far from our xdocs format and could probably be easily modified ) - Second step: hook the wiki to CVS so that modifications are saved in our Maven CVS, directly in xdocs format. This is possible with MoinMoin and probably with others too. - Note: The MoinMoin wiki also has a "comment" field that could be used as the CVS commit message. We could force the need to have a non-blank text if we wish to make sure there are commit messages. - We get automatically CVS email notifications whenever pages are modified and we can thus easily control the changes made to the wiki and correct when and if needed. Conclusion: - We keep the advantage of our xdocs - We can still edit xdocs directly should we wish - Anyone can contribute easily to the documentation and we get good and up to date Maven documentation. If we agree, there are things to do: - We need to find a machine where the wiki could run (it could be a machine provided by a Friend Of Maven or an Apache one if there's one available) - We need someone to look at MoinMoin (or another wiki) to perform the following: - find how to hook it to CVS - find how to change the default style to be the Maven style (stylesheet) - find how to modify the DTD so that the xdocs are in the Maven xdocs format - find how to define where xdocs are saved in CVS so that we try to match the existing locations of xdocs - We need a Wiki admin What do you think? Thanks -Vincent --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org For additional commands, e-mail: dev-help@maven.apache.org --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org For additional commands, e-mail: dev-help@maven.apache.org