Recommended Change to Author LIsting in Documentation
chris.good at ozemail.com.au
Mon Dec 12 00:48:49 EST 2016
> Message: 2
> Date: Sat, 10 Dec 2016 23:49:38 +0500
> From: "David T." <sunfish62 at yahoo.com>
> To: "David T. via gnucash-devel" <gnucash-devel at gnucash.org>
> Subject: Recommended Change to Author LIsting in Documentation
> Message-ID: <648ED8FF-7D36-4D18-8331-90D9E11E03D2 at yahoo.com>
> Content-Type: text/plain; charset=utf-8
> In response to seeing yet another new user sending a support request
> directly to one of the people mentioned in the documentation, I created
> 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
> 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
> 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
> 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
> that this list omits email addresses. In addition, add a note there about
> 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
> the GnuCash lists (gnucash-users and gnucash-devel) for further
> John Ralls thought that this change should be run past the Devel list, and
> 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.
> David T.
Sounds good to me.
A link to https://wiki.gnucash.org/wiki/Mailing_Lists would be good.
-------------- next part --------------
A non-text attachment was scrubbed...
Size: 4817 bytes
Desc: not available
More information about the gnucash-devel