Recommended Change to Author LIsting in Documentation

Alex Aycinena alex.aycinena at gmail.com
Sun Dec 11 13:17:55 EST 2016


>
>
> ---------- Forwarded message ----------
> From: Geert Janssens <geert.gnucash at kobaltwit.be>
> To: gnucash-devel at gnucash.org, "David T." <sunfish62 at yahoo.com>
> Cc:
> Date: Sat, 10 Dec 2016 22:48:48 +0100
> Subject: Re: Recommended Change to Author LIsting in Documentation
> 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
>
>
So do I.

Alex


More information about the gnucash-devel mailing list