After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 775919 - Change Documentation of contributors
Change Documentation of contributors
Status: RESOLVED FIXED
Product: GnuCash
Classification: Other
Component: Documentation
2.6.14
Other All
: Normal normal
: ---
Assigned To: gnucash-documentation-maint
gnucash-documentation-maint
Depends on:
Blocks:
 
 
Reported: 2016-12-10 06:08 UTC by David
Modified: 2018-06-29 23:52 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description David 2016-12-10 06:08:16 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."
Comment 1 John Ralls 2016-12-10 15:43:38 UTC
David,

Thanks, good thoughts. But this needs to be discussed first on the dev list for the wider audience there.
Comment 2 John Ralls 2016-12-15 21:45:38 UTC
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.
Comment 3 John Ralls 2018-06-29 23:52:37 UTC
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.