Guys, I think you need to be careful placing too much weight on the Wiki. It forces one to do more-or-less text-based documentation and, as you all know, Avalon's documentation can not be called "diagram-rich". ;) To me, Wiki should be treated only as a pre-documenation stage/container for hot thoughts and ideas before the real thing is going to be produced. People should be able to read/download a comprehensive documentation that explains concepts using diagrams supported by reasonable good explanation. I don't think you will be able to get away with old email and Wiki, most users are not going to buy this.
Pawel From: "Farr, Aaron" <[EMAIL PROTECTED]> on 03/02/2004 10:52 AM PST Please respond to "Avalon framework users" <[EMAIL PROTECTED]> To: "'Avalon framework users'" <[EMAIL PROTECTED]> cc: Subject: RE: PowerPoint presentation > -----Original Message----- > From: Niclas Hedhman [mailto:[EMAIL PROTECTED] > Sent: Tuesday, March 02, 2004 1:40 PM > To: Avalon framework users > Subject: Re: PowerPoint presentation > > On Wednesday 03 March 2004 02:26, Leo Simons wrote: > > Vikas Phonsa wrote: > > > I think it is wrong to assume that people would take wikis very > > > seriously, typical mentality is to look for information on the website. > > > > lets just ditch the website and put it all in a wiki then! (or, let's > > change that mentality) > > Maybe this was a joke, but think about it for a second... Don't think it was a joke (knowing Leo's thoughts about wiki's). In fact, it's a decent idea that many other open source projects (not necessarily here in the ASF) have used. > If we change the LOOK on the Wiki to be identical to the main site (or > vice > versa), we could actually place Wiki links in the main documentation, and > most users wouldn't reflect too much which one is which. > > Once the page is matured, it can be re-worked to xdoc, brought in under > the > "official docs" banner, committed to CVS and all of that. They can be reworked and republished (this could perhaps be automated) or the wiki would be improved to the point that there's no reason to republish. One example of a project which uses it's wiki well is the Keel Framework: http://keelframework.org/ http://66.105.113.115/vqwiki-2.3.5/jsp/Wiki?StartingPoints Most of their serious documentation is in the wiki. J. Aaron Farr SONY ELECTRONICS DDP-CIM (724) 696-7653 --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] American Express made the following annotations on 03/02/2004 08:59:09 PM ------------------------------------------------------------------------------ ****************************************************************************** "This message and any attachments are solely for the intended recipient and may contain confidential or privileged information. If you are not the intended recipient, any disclosure, copying, use, or distribution of the information included in this message and any attachments is prohibited. If you have received this communication in error, please notify us by reply e-mail and immediately and permanently delete this message and any attachments. Thank you." ****************************************************************************** ==============================================================================
