Recommended Change to Author LIsting in Documentation

[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.

Geert