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 692957 - Update Section 4.2.2 of Tutorial
Update Section 4.2.2 of Tutorial
Status: RESOLVED FIXED
Product: GnuCash
Classification: Other
Component: Documentation
unspecified
Other All
: Normal normal
: ---
Assigned To: Yawar Amin
Tom Bullock
: 521046 (view as bug list)
Depends on:
Blocks:
 
 
Reported: 2013-01-31 18:34 UTC by David
Modified: 2018-06-29 23:13 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description David 2013-01-31 18:34:55 UTC
Modifications to improve the text.

Original text:

To add the paycheck split transaction from the Assets:Checking account register window, click on a new transaction line and click Split. Enter the description of this transaction on the first line (e.g. “Employers R Us”). In the split line below this, enter the various splits that make up this transaction, one by one. To enter the splits, first choose the account, then enter the amount by which to change the account. Then click the next split line and repeat the process.

Modified text:

To add the paycheck split transaction from the Assets:Checking account register window, click on a new transaction line and click Split. Note that if you have set your register view to Auto-Split or Transaction Journal, the splits will be opened for you. Enter the description of this transaction on the first line (e.g. “Employers R Us”). In the split line below this, enter the various splits that make up this transaction, one by one. To enter the splits, first choose the account, then enter the amount by which to change the account. Then click the next split line and repeat the process. Note that if you are using the keyboard to navigate the transaction, use Tab to move from field to field, as using Enter will commit the transaction and create splits to an Imbalance account.
Comment 1 David Carlson 2013-02-09 16:25:10 UTC
Additional text:

For the Assets:Checking account line the amount should be entered in the left hand 'Deposit' column.  Other deductions itemized also go in the left hand 'Deposit' column.  The Income:Salary amount goes into the right hand 'Withdrawal' line.  While you are entering the data, a line at the bottom of the transaction will show the net amount of 'Imbalance'. If that amount is not zero when you press the Enter key, a line will be added with the account name "Imbalance' and that amount.

Note: Actually the lines can be entered in any order but when the Enter key is pressed to complete the transaction, all left hand column amounts will jump ahead of all right hand column amounts.  Keep that in mind if you want the order of the lines in the transaction to approximately match the order on the pay stub.
Comment 2 David 2013-02-09 19:43:08 UTC
I think that the information you provide here would be better placed in section 2.2.3, which addresses Transactions directly. 

The Left column/Right column point needs to be rewritten to explain the underlying accounting principle, which I don't have in my brain.

The rearranging splits information will fit in easily in 2.2.3.

I will work up another bug for all this.
Comment 3 David Carlson 2013-02-09 19:55:31 UTC
Sounds good to me.
Comment 4 David Carlson 2013-02-09 20:08:15 UTC
One of the points that I wanted to address in the Left Column/Right Column explanation is that many people will find it counter-intuitive to enter Income as a "Withdrawal' if the columns have the informal labels.
Comment 5 David 2013-02-09 20:46:07 UTC
Take a look at Bug 693493. I'm not sure it goes far enough in explaining your point about the headings for income accounts, but there is a complicating factor regarding the column labels, which is that users have the option of formal accounting terms or the Quicken-friendly headings. I believe that's already described somewhere, though, so any such discussion should refer to that existing text.
Comment 6 John Ralls 2013-12-23 01:03:50 UTC
Is it correct that bug 693493 superseded this one, and since the changes there have been committed, this one can be closed too?
Comment 7 David 2013-12-23 07:48:24 UTC
I don't think so. 693493 covers a concern raised in comment 1. The basic emendation proposed here still needs to be added. However, the Left/Right column explanation never got added. Here is another version:

To add the paycheck split transaction from the Assets:Checking account register window, click on a new transaction line and click Split. Note that if you have set your register view to Auto-Split or Transaction Journal, the splits will be opened for you. Enter the description of this transaction on the first line (e.g. “Employers R Us”). In the split line below this, enter the various splits that make up this transaction, one by one. To enter the splits, first choose the account, then enter the amount by which to change the account. Keep in mind that when in an asset account register, amounts entered in the left column increase the transaction value, while amounts entered in the right column decrease the value (for more about this, see 2.2.3). Tab or click the next split line and repeat the process. Note that if you are using the keyboard to navigate the transaction, use Tab to move from field to field, as using Enter will commit the transaction and create splits to an Imbalance account.
Comment 8 John Ralls 2013-12-23 20:35:51 UTC
OK, r23601 with one small change: The column the amount is in affects whether the split increases or decreases the *account balance*. It has no effect on the *transaction value*, which is always 0 because the transaction must balance.
Comment 9 John Ralls 2013-12-23 23:58:06 UTC
*** Bug 521046 has been marked as a duplicate of this bug. ***
Comment 10 John Ralls 2018-06-29 23:13:11 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=692957. Please update any external references or bookmarks.