GNOME Bugzilla – Bug 775919
Change Documentation of contributors
Last modified: 2018-06-29 23:52:37 UTC
Having once again seen a new user address their general concerns to one of the listed members of the "GnuCash Documentation Team," rather than to gnucash-users, I think it's time to find a different way to register the contributors so that these new users get directed to the proper channels for help, while retaining attribution of contribution. 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."
David, Thanks, good thoughts. But this needs to be discussed first on the dev list for the wider audience there.
I've made this as close as possible to what you requested without messing with the XSL templates that format the DocBook into the actual output. We'll see how it goes; because it will take several years before all of the older versions of the documentation disappear from the world it will be a long time before we can be sure that it worked.
GnuCash bug tracking has moved to a new Bugzilla host. This bug has been copied to https://bugs.gnucash.org/show_bug.cgi?id=775919. Please update any external references or bookmarks.