Recommended Change to Author LIsting in Documentation

Christian Stimming christian at cstimming.de
Sun Dec 11 12:13:23 EST 2016


Am Samstag, 10. Dezember 2016, 22:48:48 schrieb Geert Janssens:
> Op zaterdag 10 december 2016 23:49:38 CET schreef David T. via gnucash-
devel:
> > Hi,
> > 
> > In response to seeing yet another new user sending a support request
> > directly to one of the people mentioned in the documentation, I created
> > Bug
> > 775919 (https://bugzilla.gnome.org/show_bug.cgi?id=775919
> > <https://bugzilla.gnome.org/show_bug.cgi?id=775919>) as a proposed change
> > to the way that the docs present the author attributions. In that bug, I
> > state:
> > 
> > I recommend the following:
> > 
> > 1) Remove all individual names and email addresses from the documentation
> > title page, and replace them with a general attribution to "The GnuCash
> > Documentation Team." Since the current copyright is to this entity, I
> > think
> > this is not only convenient, but also more accurate than the current list.
> > 
> > 2) Place a large note on the title page identifying gnucash-users as the
> > proper location to which to direct help requests. Section 2.4.2 is clearly
> > not prominent enough for new users.
> > 
> > 3) Retain the list of contributors that show on the title page verso. I
> > will note that this list omits email addresses. In addition, add a note
> > there about who and what the GnuCash Documentation Team is.
> > 
> > I propose: "The GnuCash Documentation Team is a self-designated group of
> > GnuCash users and developers who have volunteered to write this
> > documentation for the benefit of the broader user base. People who are
> > interested in joining this group are encouraged to express their interest
> > on the GnuCash lists (gnucash-users and gnucash-devel) for further
> > direction.” John Ralls thought that this change should be run past the
> > Devel list, and so here I am, giving it a run. As one of the named
> > contributors, I personally would prefer that my email not be included in
> > the documentation, but I defer to the general interest of the group.
> > 
> > Cheers,
> > David T.
> 
> Good idea! I agree to all your proposals.

Yes, I agree, too. Thanks for changing this!

Regards

Christian



More information about the gnucash-devel mailing list