Bug 379747

More details: The payee default account tab not documentated

First I collected all files having release info != 4.8.1, which are

doc/credits.docbook
doc/details-accounts.docbook
doc/credits.docbook
doc/details-budgets.docbook
doc/details-categories.docbook
doc/details-currencies.docbook
doc/details-database.docbook
doc/details-forecast.docbook
doc/details-formats.docbook
doc/details-institutions.docbook
doc/details-investments.docbook
doc/details-ledgers.docbook
doc/details-loans.docbook
doc/details-payees.docbook
doc/details-reconciliation.docbook
doc/details-reports.docbook
doc/details-schedules.docbook
doc/details-search.docbook
doc/details-settings.docbook
doc/details-tags.docbook
doc/details-widgets.docbook
doc/faq.docbook
doc/firsttime.docbook
doc/installation.docbook
doc/makemostof.docbook
doc/reference.docbook

Here are a few notes I found on reviewing the mentioned docbook files:

doc/details-accounts.docbook:details.accounts.edit - image is missing checkbox "opening balance account"
doc/credits.docbook - cannot say if up to date
doc/details-categories.docbook - okay
doc/details-currencies.docbook - image does not have "New currency", "delete currency"
doc/details-reconciliation.docbook - german translation - "Clearing transactions" - not translated image

doc/details-reconciliation.docbook - german translation - "Clearing transactions" - not translated image
I never thought about whether all images in the translated manual are the originals, or if someone has gone to the effort of replicating every image in the appropriate translation.  If this one image is different from the others, then I suppose the German translation team is who should fix it.

doc/details-accounts.docbook:details.accounts.edit - image is missing checkbox "opening balance account"
doc/details-currencies.docbook - image does not have "New currency", "delete currency"
I do not think it is worth replacing the images, especially if it would mean they also need to be replaced in the translated versions, but I will add notes in the text about the new features.

(the following changes are still only in my local repository.  I will defer pushing them until I have done all of them referred to here.)

I have added a general note to the introduction that some chapters of the manual may not be fully up to date.

doc/details-currencies.docbook - image does not have "New currency", "delete currency"
I have updated this chapter to refer to these new buttons.

doc/details-accounts.docbook:details.accounts.edit - image is missing checkbox "opening balance account"
This checkbox only appears when editing an equity account.  Can someone please confirm that this was added to let a user create an account other than the original "Opening Balances" account to hold amounts used as opening balances for other accounts.  To use it, you must first create another equity account, then edit that account, and check the box.

Regarding the opening balances checkbox: it has been added to identify an equity account as the opening balances account for a currency. This was needed to allow the user to change the name of the opening balances account. Otherwise, the application insists of using only "Opening balances" possibly translated but otherwise fix. In various cases, the checkbox is grayed out (disabled). Hovering over it with the mouse will show a tooltip explaining why it is disabled.

Just a status update - about half the manual was updated for 5.0.  New screenshots have been committed for 5.0.2.  We now have three people working on updating the rest of the manual, but it is not likely to be done in time for 5.0.2, hopefully it will be complete for 5.1 (not yet scheduled)

With 4.8.3 nothing has been changed in the doc. Will rethink on making release 4.8.4 to update version numbers.

I apparently forgot about this bug, but I can add some information.  At this point, there has not been any further work on anything related to the 4.8 releases in a long time, and I doubt there will be.  The manual in the 5.1 branch of git has been updated in several areas since this bug was filed, and there is a page in the handbook listing which chapters have and have not been updated, but is still not fully updated for 5.x.  While there may be a 5.1.4 release, I do not plan on putting any further effort towards the documentation for 5.1.
I have recently started a complete review of the handbook based on the code in master branch.  I am about 1/3 of the way through a first pass.  This can be viewed in the Handbook-5.2 branch of git.  I am only pushing my updates when I have gone through several additional chapters.  I am not initially pushing this to master branch, so the translators do not have to deal with multiple changes while I continue to make multiple repeat changes to some sections.  The intent is that this will be ready about the same time master branch is ready for a release we have been calling 5.2 - some time later this year.