sunfish62 at yahoo.com
Mon Jan 26 22:00:05 EST 2015
I was looking through the open list of Documentation bugs that John linked to before the last major release, and took a look at the above bug.
The bug recommends structuring the Concepts guide to follow the overall structure outlined in Section 1.3 "About This Book".
There are a couple of points about this bug.
First, it seems to me that the original portion of the bug could be addressed by adding a one sentence summary to each chapter listed here. This would assist users in finding the material most germane to their need for guidance. If others agree, I could provide those sentences, and this bug could be closed.
Second, the only comment on the bug raises an important aspect of the software that isn't really well-addressed anywhere in the documentation--specifically, the differences between personal use and business use, and how to determine where that line gets drawn.
This lack of delineation crops up somewhat regularly on the user list. Questions on how to use Gnucash for personal use get answers from a business perspective, and vice versa with striking frequency. It seems to me that most requests for help on the list have to negotiate this distinction. By finding a way to bring the concept of Business vs. Personal Use more to the forefront, it might at least get new users thinking about this before they send in their request for help, which in turn would allow list users to hone in on the right solution to the problem at hand.
Looking at the Tutorial documentation, it seems to me that the appropriate spot for this would be in Chapter 1. I believe that the first few sections of Chapter 1 should be extensively rewritten to make them more formal--and while that was taking place, I would strive to include this distinction. I am neither an accountant nor a business user of Gnucash, however, and so any discussion I would provide would be superficial at best, and misleading at worst.
If there is general agreement with this direction, I would:
1) Add chapter descriptions for section 1.32) Spin off the Business vs. Personal ideas as a new documentation bug, and3) Begin work on a rewrite that incorporates any discussion and insights that the developers have in regards to the Business vs. Personal use issue.
More information about the gnucash-devel