Recommended Change to Author LIsting in Documentation
sunfish62 at yahoo.com
Sat Dec 10 13:49:38 EST 2016
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.
More information about the gnucash-devel