Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

ch_Account-Actions: Backport the completely German version #314

Open
wants to merge 1 commit into
base: stable
Choose a base branch
from

Conversation

jralls
Copy link
Member

@jralls jralls commented Mar 27, 2023

Recreate #255

@CWehli CWehli force-pushed the C_help_BP_acc_actions branch from 5460c4a to d4e8a5c Compare April 12, 2023 13:20
@CWehli
Copy link
Contributor

CWehli commented May 13, 2023

@jralls, @fellen : please check. It's the backport of the German improvements.

@jralls
Copy link
Member Author

jralls commented May 14, 2023

@CWehli, @Fell, ISTM this belongs in the T&CG. Any material that's here should be added there and this chapter deleted.

@CWehli
Copy link
Contributor

CWehli commented May 14, 2023

@jralls, @Fell,

ISTM this belongs in the T&CG. Any material that's here should be added there and this chapter deleted.

In principle, I agree, as this section does not describe the user interface.
However, I also find that this section helps the reader of the manual by describing the account types, because hereby the relationships between the individual accounts are explained.
I'm not hung up on the section, so if you think it fits better in the guide, I'll throw it out here and refer to Guide Chapter 3, GnuCash Accounts in the other sections instead.

@jralls
Copy link
Member Author

jralls commented May 14, 2023

@CWehli, redundancy is bad. There's an explanation of the account types in the guide and because it's a fundamental element of accounting that's the right place for it. The manual should describe the selector and point to the section in the guide for more information about the different account types.

@CWehli CWehli force-pushed the C_help_BP_acc_actions branch from d4e8a5c to e346145 Compare May 15, 2023 15:35
The type of accounts are already described in the Tutorial & Concept
Guide.
@CWehli CWehli force-pushed the C_help_BP_acc_actions branch from e346145 to e29f03b Compare July 30, 2023 17:54
@CWehli
Copy link
Contributor

CWehli commented Jul 30, 2023

@jralls, @fellen :
I've removed the explanation of account types. Please merge and then i will go on.
The next step will be the backport of section 'New Account Hierarchy Setup'

@fellen
Copy link
Member

fellen commented Jul 31, 2023

I just detected this PR.
@jralls I see it different. At least I am missing the translation of https://www.gnucash.org/docs/v4/de/gnucash-help/acct-types.html
Reason. While there are 5 types known from accounting 1X1, there are a bunch of GnuCash specific accounts. Why are they special and how relate they to the standard hierachy? That should be answered before creating charts of account or operating on them.
They are technical, not didactical, and GUI related as they fill several dropdown lists.
See it as a user friendly variant of https://code.gnucash.org/docs/MAINT/group__Account.html.

@jralls
Copy link
Member Author

jralls commented Jul 31, 2023

@fellen, rubbish. Most of the Guide is Gnucash-specific. The various account types are all described in detail in various parts of it and I have no objection to the detailed table being added to the end of 2.1.1, ideally enhanced with pointers to subsequent chapters where each account type is described with more detail.

FWIW my Accounting 101 (and that was its actual title in the catalog) class covered a lot more than the 5 types covered in Guide section 2.1.1. It was naturally business-oriented so it didn't mention credit cards or mutual funds, but it did cover current, real, fixed, and intangible assets, short-term and long-term liabilities, reserve accounts, suspense accounts, and contra-accounts, and the differences between cash and accrual accounting.

@fellen
Copy link
Member

fellen commented Jul 31, 2023

I still see it different.
The manual is still missing the description of the Chart of Accounts view. And inside of that the tables belong to the column description of Account Type. Then the tables should be referenced in Create or Edit an Account as field description of Account Type— for Create only the first table, for Edit both.

And I see nothing didactic in this overview, so the guide would be the wrong part.

@jralls
Copy link
Member Author

jralls commented Aug 1, 2023

The manual is still missing the description of the Chart of Accounts view.

That's because it's in the Guide.

And inside of that the tables belong to the column description of Account Type.

Yup. But instead that table is on here in the manual without any context.

And I see nothing didactic in this overview, so the guide would be the wrong part.

I dunno what you mean by "didactic"; in English it means designed or intended to teach. That applies to both documents. If you're trying to say that the Guide should be only about the basics of accounting then that's just the first section of the first chapter. The rest of it is about how to use GnuCash.

@fellen
Copy link
Member

fellen commented Aug 1, 2023

The rest of it is about how to use GnuCash.

That should develope into the direction Approachs to get the best/efficient results from using Gnucash instead of repeating basic views.

@jralls
Copy link
Member Author

jralls commented Aug 1, 2023

That should develope into the direction Approachs to get the best/efficient results from using Gnucash instead of repeating basic views.

OK. If you're going to do a ground-up rewrite (not a bad idea), consider creating a single document from both pieces. The manual is conceptually somewhat obsolete: I think it was intended as a home for the "context-sensitive" documentation reached by the help buttons (hence the old name), but the industry has moved away from that to things like tooltips and that's how most new features are documented in GnuCash too. There's not a lot of point to reciting the menus and list-box contents anyway: Users can see that for themselves by using the program and it makes for very dry reading.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants