> On Dec 14, 2016, at 8:01 AM, David T. <sunfis...@yahoo.com> wrote: > > Thanks John. That looks pretty good, although I think we should continue to > look for ways to bring the lists to new users’ attention. > > David > > P.S., Thanks for the leads on the copyright question. I read a bit of that, > and see how involved it can get. > >> On Dec 14, 2016, at 5:37 AM, John Ralls <jra...@ceridwen.us> wrote: >> >> >>> On Dec 10, 2016, at 10:49 AM, David T. via gnucash-devel >>> <gnucash-devel@gnucash.org> wrote: >>> >>> 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. >> >> I couldn't get anything beyond the author on either side of the title page, >> so I've reduced the author list to "The GnuCash Documentation Team" and >> added a preface block titled "About the Author" with David's proposed >> paragraph and then "Contributors to the team so far have been:" followed by >> a list of authors and translators for the document in question. >> >> Note to Frank, Mechtilde, and Pedro: I did this in English on the German and >> Portuguese translations. If you can get this translated by Saturday for the >> release that would be great. I'd rather not use Google Translate. >> >> I've also cleaned up the "More Help" section and applied it to the Guide as >> well as the Help. It's at the end of the first chapter (Overview) in the >> Guide and the second (Using this Document and Getting Help) in Help. Would >> it be better to make it preface material to make it more prominent? >> >> The changes should show up in tomorrow's docs nightlies, >> http://code.gnucash.org/docs/. The "C" directory has the English version. I >> didn't copy the updated "More Help" into the German or Portuguese >> translations; Italian is generated so it will be there too, but in English.
David, Do you think making the support page "Preface" material--so that it comes either just before or just after "About the Author" might make it more prominent? As for the copyright stuff, yeah, it gets pretty involved. I know a bit about it only because it's a frequently-beaten drum in genealogy circles. Regards, John Ralls _______________________________________________ gnucash-devel mailing list gnucash-devel@gnucash.org https://lists.gnucash.org/mailman/listinfo/gnucash-devel
