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. 
_______________________________________________
gnucash-devel mailing list
gnucash-devel@gnucash.org
https://lists.gnucash.org/mailman/listinfo/gnucash-devel

Reply via email to