I will put this into Bugzilla as a new bug/enhancement request for the documentation. There, we can begin the process of making the necessary changes. I imagine that there will be a rather large number of changes necessary to make this restructuring work. I honestly hope we'll hear from the document Guru, Yawar about, though!
David ________________________________ From: Geert Janssens <[email protected]> To: [email protected] Sent: Tuesday, November 6, 2012 12:46 AM Subject: Re: Bug 687290 Looks good to me. And thank you working on improving oor documentation. Geert On 06-11-12 06:03, David T. wrote: > Thanks for the input. My comment on the bug reinforces your ideas presented > here. Although I would put the chapter on Transactions first, simply because > understanding that is fundamental to all the rest. Budgets and Multiple > Currencies would go after, since they are optional for many users. > > Restructuring as you suggest would, I believe, require a more substantial > framework. I would want that framework to be more clearly delineated in the > overall document structure, so that readers would see that the chapters are > definitely using the equation as their overarching structure. I'm not sure > how that would most effectively be achieved. Would we create new top-level > chapters, and embed the existing chapters in these new chapters? That might > be the best. > > > Perhaps we would end up with a chapter structure like this: > > 1. Overview > 2. The Basics > 2.1 Accounts > 2.2 Transactions > 3. Asset Accounts > 3.1 Checking Accounts > 3.2 Investments > 3.3 Other Assets > 4. Liability Accounts > 4.1 Credit Cards > 4.2 Loans > 4.3 Other Liabilities [to parallel 3.3] > 5. Equity Accounts > [mumble] > 6. Income Accounts > 6.1 [mumble] > 6.2 Capital Gains > 6.3 Other Income Accounts > 7. Expense Accounts > [mumble] > 8. Multiple Currencies > 9. Budgets > 10. Business Features > 10.1 A/R > 10.2 A/P > 10.3 Payroll > 11. Extending Gnucash > 11.1 Custom Reports > 11.2 Python Extensions > > > > > > ________________________________ > From: David Carlson <[email protected]> > To: [email protected] > Sent: Sunday, November 4, 2012 10:12 AM > Subject: Re: Bug 687290 > > On 10/31/2012 4:40 PM, David T. wrote: >> I have just put an initial draft chapter for the Tutorial on Bugzilla in the >> referenced bug, to cover expense accounts. >> >> I welcome suggestions for correction! >> >> David >> _______________________________________________ >> gnucash-devel mailing list >> [email protected] >> https://lists.gnucash.org/mailman/listinfo/gnucash-devel >> > I have added a couple of comments to bug 697290. > > These are my thoughts. I think that expenses do deserve an entire > chapter. However, I would structure existing chapters five through > nine, sixteen and expenses to fit into the framework suggested by > chapter two's reference to the five basic account types. This would > mean that chapters on asset account topics (Checkbook, Investments and > Other Assets) be grouped together, liability account topics (Credit > Cards and Loans) together, Income (Capital Gains) as a unit and Expenses > as a unit. Transactions, Budgets and Multiple Currencies apply to all > account types, and should be after the account type sections. > > Business topics should be separate as they are now. > > David C > > _______________________________________________ > gnucash-devel mailing list > [email protected] > https://lists.gnucash.org/mailman/listinfo/gnucash-devel > _______________________________________________ > gnucash-devel mailing list > [email protected] > https://lists.gnucash.org/mailman/listinfo/gnucash-devel _______________________________________________ gnucash-devel mailing list [email protected] https://lists.gnucash.org/mailman/listinfo/gnucash-devel _______________________________________________ gnucash-devel mailing list [email protected] https://lists.gnucash.org/mailman/listinfo/gnucash-devel
