Ivan Adzhubey wrote: > On Tuesday 18 September 2007 04:12:14 pm Dan Langille wrote: > >> On 18 Sep 2007 at 16:02, Ivan Adzhubey wrote: >> >>> Hi Dan, >>> >>> On Tuesday 18 September 2007 03:48:55 pm Dan Langille wrote: >>> >>>> On 18 Sep 2007 at 15:43, Ivan Adzhubey wrote: >>>> >>>>> Hi, >>>>> >>>>> As many of you probably noticed more than once when consulting Bacula >>>>> documentation pages on www.bacula.org, they are full of typing >>>>> errors, omissions, incomplete descriptions, sometimes confusing >>>>> explanations and so on (together with lots of essential examples, >>>>> hints and other bits and pieces of invaluable wisdom of course). >>>>> Since documenting such a complex and sophisticated package is a huge >>>>> work and developers often have more important things to spend their >>>>> time on (understandable), why not to put it on the wiki pages and >>>>> allow everyone to contribute? At least then we can get rid of that >>>>> annoying typing errors in no time. >>>>> >>>> See http://wiki.bacula.org/doku.php >>>> >>>> Good idea. >>>> >>> Yes, I am aware of Bacula wiki server but there is no official Bacula >>> User's Guide to be found there and that was my point (sorry if it was not >>> clear from my post). I'd suggest putting *official* Bacula User's Guide >>> on the wiki and link it from the Bacula home page as the main source of >>> documentation *instead* of the static HTML guide we have now. Wiki also >>> allow to easily set up (and more importantly, continue to maintain and >>> update) User Guides for older Bacula versions, something many users asked >>> for. >>> >> How would this tie into subversion? >> >> I would like to see each version of the manual online. >> >> BTW, there is nothing stopping anyone from just doing this. Do it. >> Prove it works. Don't ask for permission. Get it done, get people >> correcting, then go from there. :) >> >> Much like http://snapshots.bacula.org/ >> > > I was thinking about it. We happen to run the same DokuWiki engine used on > Bacula Wiki for our internal collaboration projects here so setting up a > section on Bacula should be easy and it will be possible to import it into > Bacula Wiki later. Still, having it on official Bacula web site from the > start would be better.
Based on the discussion here, I created an account for myself on the bacula docu wiki. Then I edited a page, and also browsed through everything. It says something that I was able to browse through everything -- what is there now is very limited. And the mechanism for contributing fixes for the official documentation, as Ivan says, does make it rather difficult to contribute in a productive fashion. Way too much overhead and distance between what you are doing and the actual official documentation that you want to impact. So, Dan, are you suggesting that someone should just go in and start creating pages and pouring in and formatting the official documentation? So, this would become an alternate documentation universe where people could easily contribute and correct? If so, how then would that connect back to the "official" documentation? --------------- Chris Hoogendyk - O__ ---- Systems Administrator c/ /'_ --- Biology & Geology Departments (*) \(*) -- 140 Morrill Science Center ~~~~~~~~~~ - University of Massachusetts, Amherst <[EMAIL PROTECTED]> --------------- Erdös 4 ------------------------------------------------------------------------- This SF.net email is sponsored by: Microsoft Defy all challenges. Microsoft(R) Visual Studio 2005. http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/ _______________________________________________ Bacula-users mailing list Bacula-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/bacula-users
