Re: [Bacula-users] [Bacula-devel] Bacula manual is too outdated
2017-07-22 15:29:53
Hello Wanderlei, Unfortunately, the community has rarely contributed to the
manual, though they have feed in lots of information that I have
put in the manual. Perhaps 1 of every 20 submissions comes with
documentation. So it all falls on my back. There is one
exception to that, and it is the Enterprise manual, which is
improving. I have a project going with Bacula Systems to ensure
that there is only one manual source rather than the two that
currently exist. Consequently there is a chance that within the
next 6 months to a year that the manual will improve. Developers including me detest writing documentation. I write it
because otherwise I spend too much time on support. Even with a
perfect manual, I spend too much time on support, because a lot of
people do not read it. Those are just facts of nature that we
must live with unless a fairy goddess comes along and sprinkles
some mother tongue technical person with fairy dust that causes
him/her to get interested in the manual. Best regards, Kern
On 07/21/2017 06:38 PM, Wanderlei
Huttel wrote:
Hello Kern
Always when is necessary to take a look in the manual is
painful, because there are a lot of new features and
improvements that not well documented and many times when we
doesn't achieve what we want, we give up.
How could the bacula community could help to keep manual
up to date? In the last releases it looks only "new
features" was updated.
There are many settings it would be interesting to have more
examples to be clearly.
Documentation is one of the easiest ways for community members to contribute to a project. No coding skills required. It is much easier than it sounds.
If anyone wants to get started, the bacula documentation mailing list archive has some suggestions regarding simple changes.
I'm on that mailing list, so if anyone want to get started, I'm happy to guide.
|
------------------------------------------------------------------------------
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot _______________________________________________
Bacula-users mailing list
Bacula-users AT lists.sourceforge DOT net
https://lists.sourceforge.net/lists/listinfo/bacula-users
|
ADSM.ORG Privacy and Data Security by https://kimlaw.us
|