> I have been using bacula for a year now, before setting up a small > config I started by reading the whole manual. Now I know where to look > for what when i need to. I think if we post our configs, it no doubt > So did I, read the whole manual, maybe a couple of years ago. I think 1.36 was the first release I seriously started to use, although there were some test runs before that. Number of pages in the documentation has increased a lot during that period of time. I'm not certain I would any more know where to look for information on some new features -without very much of browsing.
I tried to re-read the manual maybe a year ago, but it was very frustrating: "I think I know this, no need to re-read". Oops, now I skipped 50 pages -wonder if there were something important new for me? Yes, there certainly was... The Bacula manual is very through and detailed, but it is a more like reference manual where you can check (or point it out to someone) what you already know, although it is mixed with examples etc. I sometimes have been thinking, that it might be worth splitting into two manuals: a detailed and precise reference manual, and introducory how to build / how to install & test run / how to configure your first (rather basic) backup system. The latter one might be enough to cover the latest version, the reference should also contain easy-to-see information since what release the feature in question has been available. And well indexed, too. > will help people find it easier to setup bacula but in the end we are > going to face more questions "I followed such-n-such config but it > doesn't work" and the infamous RTFM reply. > I agree. I think that kind of examples should be similar to ones currently in the manual: Verified and commented by someone skilled enough. Otherwise there exists the danger that "wild examples" guide to using some unwanted side effects, or features that are planned to be obsoleted in the releases to come. -- TiN ------------------------------------------------------- Using Tomcat but need to do more? Need to support web services, security? Get stuff done quickly with pre-integrated technology to make your job easier Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642 _______________________________________________ Bacula-users mailing list Bacula-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/bacula-users
