[Bf-docboard] Mentioning wiki

Bart bf-docboard@blender.org
Fri, 9 Jan 2004 11:03:43 +0100 (CET)


Hi Peter,

I agree with you that a Wiki is a nice collaboration tool. However, I 
don't think it is suitable for our purposes: you are forced to work 
on-line, wiki's usually do not have the capabilities that DocBook offers 
us such as image inclusion (although I know there are exceptions such as 
Twiki), and, most importantly, Wiki does not offer us the possibility to 
export the content to a variety of output formats such as PDF and RTF.

If I am not mistaken the Open Content Licence will allow you to make a 
copy of the material and host it somewhere else. I don't think that 
fragmenting the documentation efforc  will do the project any good though.

Cheers,

Bart


On Wed, 7 Jan 2004, Peter Gervai wrote:

> Happy new year!
> 
> I haven't seen any reply on that below. Anyone does have any possible opinion on
> that matter? 
> 
> Is it possible (legally) to get the actual documentation and insert it on a
> wiki by my responsiblity, unrelated to you people? (Naturally referring back
> here, to the "hard-to-modify-but-official" documentation?) Actual copyright
> seem to reject that possibility, and it's not nice anyway to get it without
> the knowledge of the authors.
> 
> 
> Any reply would be much appreciated,
> Peter
> 
> 
> On Sun, Dec 14, 2003 at 02:11:17PM +0100, Peter Gervai wrote:
> > Hello,
> > 
> > I noticed in the archives (not easy due to the lack of search) that from
> > time to time people are mentioning wiki and the documentation, but I see
> > nothing got changed so far. I just write because I started to read the docs
> > (well, actually just "checking" since I don't yet have time to spend my life
> > with Blender) and in the fist 5 minutes I have noticed problems to fix. If
> > it would have been a wiki I would have went on and fixed the typos and other
> > small errors (which would not even have required any blender knowledge). You
> > people would see my changes, see what and where I did change, and either
> > smile that someone helps or revert my changes in 2 seconds.
> > 
> > Now, it isn't a wiki. So I should subscribe this list, and I am supposed to
> > TELL YOU to change this and that. For 2 mistyped words and one other small
> > cosmetics? No way.
> > 
> > Okay, you got my point I guess. But I do not want to demand to create a wiki
> > and such. I just wanted to let you know...
> > 
> > ...you can check http://wikibooks.org/ , for example
> > http://wikibooks.org/wiki/Cookbook which is a multi-chaptered one, like the
> > Blender book. It can contain chapters, pictures, formatting or whatever
> > people usually need. It's a wiki. It is well controlled: see "Page history",
> > where you see changes, see "Recent changes" which shows you every change
> > around, etc. 
> > 
> > It could be used, but I believe your license is not compatible with GFDL,
> > and you don't want to put it under GFDL anyway. But the software is
> > available (MediaWiki) and only needs PHP and MySQL. (Not that I'm a fan of
> > any of those, but they're not crap either.)
> > 
> > So, this is two possibilities (along the possibility to use other, simpler
> > wiki software like UseMod, TWiki, etc.). I would have set up a sample from
> > the doc but I did not want to put it on the GFDL Wikibooks. But it's that
> > simple.
> > 
> > Sorry for the high information/space ratio. :)
> > 
> > regards,
> > Peter
> > (who don't use Blender [yet], but still loves its interface and concepts, and
> > likes to read good documentation)
> _______________________________________________
> Bf-docboard mailing list
> Bf-docboard@blender.org
> http://www.blender.org/mailman/listinfo/bf-docboard
> 

-- 
Bart Veldhuizen, bart@vrotvrot.com
Web Droid