for a long time, several people have been unhappy with the current state
of the evolution user docs. me too, but most of my rantings have been
on irc so i can't link to them. ;-)
when evolution 2.0 became an official part of GNOME 2.8, aaron was
working full-time on the evolution docs. now my impression is that
updates get written in a hurry without any proof-reading.
it has happened twice to me that svn changes have been overwritten[2,3],
because novell uses its own user documentation management for evolution
(read: apply changes to an adobe framemaker document and then try to get
them into svn. somehow). dropping code, instead of merging. cathedral,
instead of bazaar. that's not really how open source works.
it means that patches cannot get easily committed because they would get
overwritten by novell's next commit.
also, me and other folks have spent quite some time to discuss and
explain basic gnome doc workflow stuff to the assigned writers.
the docs are still very novell-specific. red carpet is still
mentioned, for additional help you are told to visit
http://support.novell.com, sometimes it is Novellreg;
Evolutiontrade; and in general the documentation conventions haven't
been changed to gnome's conventions (markup, terminology).
also, lots of explanations are just of the read the interface back to
you type (but this is not an evolution specific problem).
when i translated the majority of the evolution user guide to german, i
have found a lot of errors. some of them have been fixed, some of the
fixes have introduced new errors (did i say proof-reading already?).
summary: there are two problems. the modus operandi of novell's doc
team and the quality of the docs.
1) novell's doc team shall use the gnome svn version as the base version
for changes and rework the doc to follow gnome's conventions. novell,
like any other distributor, may of course derivate from the gnome svn
doc as they wish to provide their own, enhanced evolution user
documentation that provides a much better desktop experience with
2) if we cannot find a consensus, fork. novell may have its own branch
for the docs, and we can port and backport changes between branches.
the gnome documentation team does not have enough manpower to update the
user documentation by itself, so i would still prefer to see the first
proposal happen. the question is whether we want to have a clean and
typo-free (but obsolete) doc, or a more-or-less up-to-date (but
error-prone and non-gnome-compliant) doc. having both
would be the best choice, of course.
mailto:[EMAIL PROTECTED] | failed
Description: Dies ist ein digital signierter Nachrichtenteil
Evolution-hackers mailing list