[office/kmymoney/Handbook-5.2] /: More initial updates

Jack Ostroff null at kde.org
Mon Aug 14 22:01:00 BST 2023


Git commit 27080b08b0822f7adb69c1742810e33abbcaf54c by Jack Ostroff.
Committed on 14/08/2023 at 23:00.
Pushed by ostroffjh into branch 'Handbook-5.2'.

More initial updates

M  +45   -1    README-CONTRIBUTORS
M  +33   -34   doc/firsttime.docbook
M  +15   -13   doc/index.docbook
M  +14   -13   doc/introduction.docbook
M  +130  -76   doc/makemostof.docbook
M  +20   -14   doc/whatsnew.docbook

https://invent.kde.org/office/kmymoney/-/commit/27080b08b0822f7adb69c1742810e33abbcaf54c

diff --git a/README-CONTRIBUTORS b/README-CONTRIBUTORS
index 8911cd4c8..e3721cdce 100644
--- a/README-CONTRIBUTORS
+++ b/README-CONTRIBUTORS
@@ -16,4 +16,48 @@ placed below the existing or target location.
 
 At some point, I will add to this doc a list of which chapters have and have
 not been edited yet, and not use the list used for the 4 -> 5 changes in the
-What's New section.
\ No newline at end of file
+What's New section.
+
+This is in the order pulled in from index.docbook, with brief note on state of update
+
+<!ENTITY introduction SYSTEM "introduction.docbook">
+  prelim update
+  
+<!ENTITY whatsnew SYSTEM "whatsnew.docbook">
+  prelim update
+  
+<!ENTITY makemostof SYSTEM "makemostof.docbook">
+  prelim update
+  
+<!ENTITY firsttime SYSTEM "firsttime.docbook">
+  prelim update
+
+<!ENTITY details-institutions SYSTEM "details-institutions.docbook">
+<!ENTITY details-accounts SYSTEM "details-accounts.docbook">
+<!ENTITY details-categories SYSTEM "details-categories.docbook">
+<!ENTITY details-tags SYSTEM "details-tags.docbook">
+<!ENTITY details-payees SYSTEM "details-payees.docbook">
+<!ENTITY details-schedules SYSTEM "details-schedules.docbook">
+<!ENTITY details-ledgers SYSTEM "details-ledgers.docbook">
+<!ENTITY details-investments SYSTEM "details-investments.docbook">
+<!ENTITY details-currencies SYSTEM "details-currencies.docbook">
+<!ENTITY details-reconciliation SYSTEM "details-reconciliation.docbook">
+<!ENTITY details-reports SYSTEM "details-reports.docbook">
+<!ENTITY details-impexp SYSTEM "details-impexp.docbook">
+<!ENTITY details-impexp-csv SYSTEM "details-impexp-csv.docbook">
+<!ENTITY details-impexp-csvexp SYSTEM "details-impexp-csvexp.docbook">
+<!ENTITY details-impexp-woob SYSTEM "details-impexp-woob.docbook">
+<!ENTITY details-loans SYSTEM "details-loans.docbook">
+<!ENTITY details-budgets SYSTEM "details-budgets.docbook">
+<!ENTITY details-forecast SYSTEM "details-forecast.docbook">
+<!ENTITY details-settings SYSTEM "details-settings.docbook">
+<!ENTITY details-search SYSTEM "details-search.docbook">
+<!ENTITY details-formats SYSTEM "details-formats.docbook">
+<!ENTITY details-database SYSTEM "details-database.docbook">
+<!ENTITY faq SYSTEM "faq.docbook">
+<!ENTITY reference SYSTEM "reference.docbook">
+<!ENTITY details-widgets SYSTEM "details-widgets.docbook">
+<!ENTITY credits SYSTEM "credits.docbook">
+<!-- no longer used? <!ENTITY details-hbciofx SYSTEM "details-hbciofx.docbook"> -->
+
+<!-- not directly included in docbook   "man-kmymoney.1.docbook" -->
\ No newline at end of file
diff --git a/doc/firsttime.docbook b/doc/firsttime.docbook
index b7551516b..60704e6a3 100644
--- a/doc/firsttime.docbook
+++ b/doc/firsttime.docbook
@@ -16,10 +16,9 @@
 
 <note>
   <para>
-    When you run &kmymoney;, it might not look exactly like the screenshots in
-    this manual.  Many details, such as fonts, colors, and icons, can be
-    customized, either using the
-    <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
+    When you run &kmymoney;, it might not look exactly like the screenshots in this
+    manual.  Many details, such as fonts, colors, and icons, can be customized, using
+    the <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
     &kmymoney;...</guimenuitem></menuchoice> menu item or the &kde; &systemsettings;
     application, depending on your operating system.
   </para>
@@ -56,18 +55,19 @@
 </itemizedlist>
 
 <para>
-  The menu and toolbars provide access to the features of &kmymoney; and allow
-  you to <link linkend="firsttime.3">Create</link> files or configure how
+  The menu and toolbars provide access to the features of &kmymoney; and allow you to
+  <link linkend="firsttime.3">Create a new data file</link> or configure how
   &kmymoney; operates.
 </para>
 
 <para>
-  On the left side of the main window, the view selector consists of at least
-  eleven icons with optional labels, depending upon the software provided by
-  your system.  More icons could be added by various plugins.  By clicking on an
-  icon, the view window on the right hand side is loaded with the appropriate
-  view of your financial data.  Each view provides a unique representation of
-  your financial situation and allows you to view or edit the information shown.
+  On the left side of the main window, the view selector consists of at least eleven
+  icons with optional labels, depending upon the software provided by your system, as
+  some features can be included or excluded when the program is compiled.  More icons
+  could be added by various plugins.  By clicking on an icon, the view window on the
+  right hand side is loaded with the appropriate view of your financial data.  Each
+  view provides a unique representation of your financial situation and allows you to
+  view or edit the information shown.
 </para>
 
 <para>
@@ -87,8 +87,8 @@
 	  </textobject>
 	</inlinemediaobject>
       </guiicon>
-      Home: A configurable overview of your current financial situation (or an
-      introduction page when no data file is open).
+      Home: a configurable overview of your current financial situation (or an
+      introduction page when no data file is open.)
     </para>
   </listitem>
 
@@ -104,8 +104,7 @@
 	  </textobject>
 	</inlinemediaobject>
       </guiicon>
-      Institutions: All of your institutions and accounts displayed in a
-      hierarchy.
+      Institutions: all of your institutions and accounts displayed in a hierarchy.
     </para>
   </listitem>
 
@@ -137,7 +136,7 @@
 	  </textobject>
 	</inlinemediaobject>
       </guiicon>
-      Scheduled Transactions: Your recurring bills and deposits.
+      Scheduled Transactions: your recurring bills and deposits.
     </para>
   </listitem>
 
@@ -153,8 +152,8 @@
 	  </textobject>
 	</inlinemediaobject>
       </guiicon>
-      Categories: Special accounts that provide a means for you to group
-      associated transactions.
+      Categories: special accounts that provide a means for you to group associated
+      transactions.
     </para>
   </listitem>
 
@@ -170,8 +169,8 @@
 	  </textobject>
 	</inlinemediaobject>
       </guiicon>
-      Tags: Special accounts that provide an additional means to Categories for
-      you to group associated transactions.
+      Tags: special accounts that provide an additional means similar to Categories
+      for you to group associated transactions.
     </para>
   </listitem>
 
@@ -187,8 +186,8 @@
 	  </textobject>
 	</inlinemediaobject>
       </guiicon>
-      Payees: All Payees used by &kmymoney;.  These are all the people or
-      organizations you pay money to or receive money from.
+      Payees: these are all the people or organizations you pay money to or receive
+      money from.
     </para>
   </listitem>
 
@@ -198,13 +197,13 @@
 	<inlinemediaobject>
 	  <imageobject>
 	    <imagedata fileref="ledgers_view.png" format="PNG"/>
-      </imageobject>
+          </imageobject>
 	  <textobject>
 	    <phrase>Ledgers View</phrase>
-      </textobject>
+          </textobject>
 	</inlinemediaobject>
       </guiicon>
-      Ledgers: Your account transactions.
+      Ledgers: your account transactions.
     </para>
   </listitem>
 
@@ -220,7 +219,7 @@
 	  </textobject>
 	</inlinemediaobject>
       </guiicon>
-      Investments: Your portfolio summary.
+      Investments: your portfolio summary.
     </para>
   </listitem>
 
@@ -236,8 +235,8 @@
 	  </textobject>
 	</inlinemediaobject>
       </guiicon>
-      Reports: A collection of useful reports, providing alternate, customizable
-      views of your financial data.
+      Reports: a collection of reports, providing alternate, customizable views of
+      your financial data.
     </para>
   </listitem>
 
@@ -253,7 +252,7 @@
       </textobject>
 	</inlinemediaobject>
       </guiicon>
-      Budgets: Your budgets.
+      Budgets: your budgets.
     </para>
   </listitem>
 
@@ -269,7 +268,7 @@
 	  </textobject>
 	</inlinemediaobject>
       </guiicon>
-      Forecast: This view provides a forecast of your accounts and categories.
+      Forecast: forecast of the balances of your accounts and categories.
     </para>
   </listitem>
 
@@ -285,9 +284,9 @@
 	  </textobject>
 	</inlinemediaobject>
       </guiicon>
-      Outbox: Used by the online banking module to provide feedback on running
-      processes.  This view is provided by the KBanking plugin and may not be
-      present on your system.
+      Outbox: used by the online banking module to provide feedback on running
+      processes.  This view is provided by the KBanking plugin and may not be present
+      on your system.
     </para>
   </listitem>
 </itemizedlist>
diff --git a/doc/index.docbook b/doc/index.docbook
index 7006546c6..2ad157a15 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -77,16 +77,13 @@
   <!ENTITY configicon "<inlinemediaobject><imageobject><imagedata fileref='icon-dialog-configure.png' format='PNG'/>
     </imageobject></inlinemediaobject>">
 
-<!-- the chapters -->
+<!-- the chapters (in order of use in the handbook -->
   <!ENTITY introduction SYSTEM "introduction.docbook">
+  <!ENTITY whatsnew SYSTEM "whatsnew.docbook">
   <!ENTITY makemostof SYSTEM "makemostof.docbook">
   <!ENTITY firsttime SYSTEM "firsttime.docbook">
-  <!ENTITY whatsnew SYSTEM "whatsnew.docbook">
   <!ENTITY details-institutions SYSTEM "details-institutions.docbook">
   <!ENTITY details-accounts SYSTEM "details-accounts.docbook">
-  <!ENTITY details-loans SYSTEM "details-loans.docbook">
-  <!ENTITY details-budgets SYSTEM "details-budgets.docbook">
-  <!ENTITY details-forecast SYSTEM "details-forecast.docbook">
   <!ENTITY details-categories SYSTEM "details-categories.docbook">
   <!ENTITY details-tags SYSTEM "details-tags.docbook">
   <!ENTITY details-payees SYSTEM "details-payees.docbook">
@@ -94,21 +91,24 @@
   <!ENTITY details-ledgers SYSTEM "details-ledgers.docbook">
   <!ENTITY details-investments SYSTEM "details-investments.docbook">
   <!ENTITY details-currencies SYSTEM "details-currencies.docbook">
+  <!ENTITY details-reconciliation SYSTEM "details-reconciliation.docbook">
+  <!ENTITY details-reports SYSTEM "details-reports.docbook">
   <!ENTITY details-impexp SYSTEM "details-impexp.docbook">
   <!ENTITY details-impexp-csv SYSTEM "details-impexp-csv.docbook">
   <!ENTITY details-impexp-csvexp SYSTEM "details-impexp-csvexp.docbook">
   <!ENTITY details-impexp-woob SYSTEM "details-impexp-woob.docbook">
-  <!ENTITY details-reconciliation SYSTEM "details-reconciliation.docbook">
-  <!ENTITY details-search SYSTEM "details-search.docbook">
-  <!ENTITY details-reports SYSTEM "details-reports.docbook">
+  <!ENTITY details-loans SYSTEM "details-loans.docbook">
+  <!ENTITY details-budgets SYSTEM "details-budgets.docbook">
+  <!ENTITY details-forecast SYSTEM "details-forecast.docbook">
   <!ENTITY details-settings SYSTEM "details-settings.docbook">
-  <!ENTITY details-widgets SYSTEM "details-widgets.docbook">
+  <!ENTITY details-search SYSTEM "details-search.docbook">
   <!ENTITY details-formats SYSTEM "details-formats.docbook">
   <!ENTITY details-database SYSTEM "details-database.docbook">
-  <!ENTITY details-hbciofx SYSTEM "details-hbciofx.docbook">
   <!ENTITY faq SYSTEM "faq.docbook">
   <!ENTITY reference SYSTEM "reference.docbook">
+  <!ENTITY details-widgets SYSTEM "details-widgets.docbook">
   <!ENTITY credits SYSTEM "credits.docbook">
+  <!-- no longer used? <!ENTITY details-hbciofx SYSTEM "details-hbciofx.docbook"> -->
 ]>
 
 <book id="kmymoney" lang="&language;">
@@ -172,11 +172,13 @@ Please at least include KDE, the KDE package it is in, the name
  of your application, and a few relevant keywords. -->
 <keywordset>
 <keyword>KDE</keyword>
-<keyword>office</keyword>
-<keyword>KMyMoney4</keyword>
 <keyword>KMyMoney</keyword>
-<keyword>kmymoney4</keyword>
 <keyword>kmymoney</keyword>
+<keyword>KMyMoney4</keyword>
+<keyword>KMyMoney5</keyword>
+<keyword>kmymoney4</keyword>
+<keyword>kmymoney5</keyword>
+<keyword>office</keyword>
 <keyword>finance</keyword>
 <keyword>accounts</keyword>
 <keyword>accounting</keyword>
diff --git a/doc/introduction.docbook b/doc/introduction.docbook
index f45c8743a..4f54b7a51 100644
--- a/doc/introduction.docbook
+++ b/doc/introduction.docbook
@@ -11,7 +11,8 @@
 <title>What is &kmymoney;?</title>
 
 <para>
-  Put simply, &kmymoney; is a personal finance manager by &kde;.  It enables
+  &kmymoney; is a personal finance manager by &kde;.  Some users prefer 
+  It enables
   users of open source operating systems and applications to keep careful track
   of their personal finances by providing a broad array of financial features
   and tools.
@@ -58,21 +59,21 @@
 <title>What &kmymoney; is not</title>
 
 <para>
-  As a personal finance manager, &kmymoney; is not intended to scale to the
-  needs of an average business.  A small business might find sufficient
-  functionality to use &kmymoney;, but features such as accounts-receivable and
-  accounts-payable are not directly supported.  Most if not all the data needed
-  for a small business, such as for reports for audit and taxation purposes is
-  present, but may need to be extracted using various reports and then processed
-  and assembled into the required formats.  In addition, it would be possible to
-  create client, supplier, document, or other features through plugins.
+  As a personal finance manager, &kmymoney; is not intended to scalesupport the needs
+  of an average business.  A small business might find sufficient functionality to
+  use &kmymoney;, but features such as accounts-receivable and accounts-payable are
+  not directly supported.  Most if not all the data needed for a small business, such
+  as for reports for audit and taxation purposes is present, but may need to be
+  extracted using various reports and then processed and assembled into the required
+  formats.  In addition, it would be possible to create client, supplier, document,
+  or other features through plugins.
 </para>
 
 <para>
-  &kmymoney; is not simply a clone of the commercially available personal
-  finance programs. Although many of the features present in &kmymoney; can be
-  found in other similar applications, &kmymoney; strives to present an
-  individual and unique view of your finances.
+  &kmymoney; is not simply a clone of any of the commercially available personal
+  finance programs.  Although many of the features present in &kmymoney; can be found
+  in other similar applications, &kmymoney; strives to present an individual and
+  unique view of your finances.
 </para>
 
 </sect1>
diff --git a/doc/makemostof.docbook b/doc/makemostof.docbook
index 0d32ddb94..018633a77 100644
--- a/doc/makemostof.docbook
+++ b/doc/makemostof.docbook
@@ -5,39 +5,45 @@
     <author><personname><firstname>Joe</firstname><surname>(joe1011010)</surname></personname>
             <email>joe1011010_km at users.sourceforge.net</email>
     </author>
+    <author> &Jack.H.Ostroff; &Jack.H.Ostroff.mail; </author>
   </authorgroup>
-  <date>2010-04-05</date>
-  <releaseinfo>5.0.4</releaseinfo>
+  <date>2023-08-15</date>
+  <releaseinfo>5.2.0</releaseinfo>
 </chapterinfo>
 
 <title>Making the most of &kmymoney;</title>
 
 <para>
-  While you could go ahead, clicking some buttons and filling in some data,
-  after a time, you could decide you have done it wrong and start again, even if
-  you did read the documentation on each part of &kmymoney;.
+  While much of &kmymoney; might be obvious to a naive user, and you could go ahead,
+  clicking some buttons and filling in some data, after a time, you might decide you
+  have done it wrong and want to start again, even if you did read the documentation
+  on each part of &kmymoney;.
 </para>
 
 <para>
-  You will get a more effective system if you spend a little time planning how
-  you are going to use &kmymoney;, so follow the steps given here.
+  You will get a more effective system and much better use of your time if you first
+  spend a little time planning how you are going to use &kmymoney;, so follow the
+  steps given here.  This may seem very simple, and indeed, it is simple, but taking
+  the time to assure that your understanding of how things work is the same as
+  &kmymoney;'s will almost certianly save you time later.
 </para>
 
 <sect1 id="makingmostof.basicaccounting">
 <title>Basic Accounting</title>
 
 <para>
-  Imagine your money as balls, or beans, and to stop them rolling around you
-  keep them in a box, or pot. Accounting, or Bookkeeping, is the process of
-  counting and keeping track of the beans in the pot, or several pots.
+  Imagine your money as balls, or beans, and to stop them rolling around you keep
+  them in a box, or pot.  Accounting, or Bookkeeping, is the process of counting and
+  keeping track of the beans in the pot, or more important, the beans in several
+  pots.
 </para>
 
 <para>
-  You have some money in the pot marked <quote>Cash</quote>. You buy some goods,
-  so you take some beans out of the cash pot and place them into another pot
-  marked <quote>Supplier</quote>. The supplier gives you some goods in exchange
-  for the cash, so you take the beans out of the pot marked
-  <quote>Supplier</quote> and put them in the pot marked <quote>Goods</quote>.
+  You have some money in the pot marked <quote>Cash</quote>. You buy some goods, so
+  you take some beans out of the cash pot and place them into another pot marked
+  <quote>Supplier</quote>. The supplier gives you some goods in exchange for the
+  cash, so you take the beans out of the pot marked <quote>Supplier</quote> and put
+  them in the pot marked <quote>Goods</quote>.
 </para>
 
 <para>
@@ -131,23 +137,45 @@
 <title>Mapping your finances to &kmymoney;</title>
 
 <para>
-  So, collect up your papers and see the following sections for each item in
-  &kmymoney;.
+  So, collect your recent financial papers and see the following sections for more
+  information on how you can map your own finances to each of the different areas of
+  &kmymoney;.  Note that each of these sections below is presented in more detail in
+  later chapters of this handbook.
 </para>
 
 <sect2 id="makingmostof.mapping.accounts">
 <title>Accounts</title>
 
 <para>
-  These hold a value. Transactions are created against one or more accounts.
+  An <quote>Account</quote> in &kmymoney; represents one ot the <quote>pots</quote>
+  of the previous section: is can be anywhere which holds your money and possessions
+  that you wish to monitor.  You generally create an account in &kmymoney; to
+  represent each different account you have in <quote>real life,</quote> whether it
+  is with a bank or other financial institution, or a store, or even just the cash in
+  your wallet.  There are sevral types of accounts available, to represent the
+  different types of places your money may be.
 </para>
 
+<para>
+  Transactions (to be described in more detail later) are created to indicate money
+  moving in or out of one or more accounts.
+</para>
+
+<para>
+  As described below, accounts can either hold money which is actually yours (assets)
+  or money which you owe (liabilities.)  Liabilities can be though of as magic post,
+  which you can take beans from even if there are not acatually any beans there, but
+  which you eventually need to replace.  
+</para>
+
+
 <sect3 id="makingmostof.mapping.accounts.asset">
 <title>Accounts - Asset</title>
 
 <para>
-  These are the accounts which hold your money and possessions that you wish to
-  monitor. The following types are available:
+  There are multiple types of Asset Accounts.  They are all essentially the same, in
+  holding your money, but there are some differences in the details of how money
+  enters and leaves the different types of accounts.
 </para>
 
 <variablelist>
@@ -173,7 +201,7 @@
     <term>Cash</term>
     <listitem>
       <para>
-        Money in your hand or wallet.
+        Money in your pocket or yoor wallet.
       </para>
     </listitem>
   </varlistentry>
@@ -211,8 +239,7 @@
 <title>Accounts - Liability</title>
 
 <para>
-  These are the accounts which represent your debts and money owed that you wish
-  to monitor. The following types are available:
+  These accounts represent your debts and money you owe to others.
 </para>
 
 <variablelist>
@@ -238,7 +265,7 @@
     <term>Liability</term>
     <listitem>
       <para>
-        Anything else you owe that is not a loan.
+        Anything else you owe that does fit the other liability account types.
       </para>
     </listitem>
   </varlistentry>
@@ -250,8 +277,11 @@
 <title>Institutions</title>
 
 <para>
-  These are completely optional and can be used to group accounts, and show a
-  total value for all accounts in each group.
+  These represent financial institutions, such as banks or investment brokers.  They
+  can be used to group accounts, and can show the total value of all your accounts
+  within that institution.  These do not need to reflect actual organizations, but
+  are for your convenience in grouping your accounts, and their use is completely
+  optional.
 </para>
 </sect2>
 
@@ -259,29 +289,42 @@
 <title>Categories</title>
 
 <para>
-  These represent non-managed income and expense accounts that do not have a
-  value. The total value of transactions is shown against each category. A
-  category or transfer account is required for each transaction.
+  A Category is a special type of account used internally by &kmymoney; to track
+  income and expenses.  These account are non-managed, because as mentioned earlier,
+  they do not have real values, and show only what you have gotten from them or
+  contributed to them.  Each category shows the total value of transactions which
+  mention it.  The principle of double entry accounting requires that every
+  transaction include a category or transfer account.  This will also be explained in
+  more detail later in the handbook.
 </para>
-</sect2>
 
-<sect2 id="makingmostof.mapping.subcategories">
+<para>
+  Income Categories are used as places from which you receive money, and Expense
+  Categories represent purposes for which you spend money.  On rare occasion, money
+  can flow the "wrong" way, such as getting a refund for an over-payment of a utility
+  bill.
+</para>
+
+<sect3 id="makingmostof.mapping.subcategories">
 <title>Sub-Categories</title>
 
 <para>
-  Categories can be split into sub-categories, but this relationship is only for
-  display purposes, as the sub-category totals are not included in the higher
-  level category total.
+  Categories can be split into sub-categories, but this relationship is primarily for
+  your conveniend, and is used for display purposes.  Most of the time, the
+  sub-category totals are not included in the higher level category total, although
+  there are specific reports and displays where this can be done.
 </para>
+</sect3>
+
 </sect2>
 
 <sect2 id="makingmostof.mapping.tags">
 <title>Tags</title>
 
 <para>
-  Tags are very similar to Categories, as they are also non-managed accounts
-  that do not have a value.  However, unlike Categories, the use of Tags is
-  completely optional.
+  Tags are very similar to Categories, as they are also non-managed accounts that do
+  not have a value.  However, unlike Categories, the use of Tags is completely
+  optional.  They can be used to group transactions for reporting purpses.
 </para>
 </sect2>
 
@@ -289,9 +332,12 @@
 <title>Payees</title>
 
 <para>
-  These are optional for transactions. They are required for Scheduled
-  transactions. A transaction history, with category, is shown against each
-  payee.
+  A Payee (or Payor) represents someone or some group to which you pay money or which
+  pays you money.  As with Tags, they are non-managed, and do not have a value.  They
+  are primarily a convenience for being able to report how much money you have sent
+  to someone or spent at a particular store.  These are optional for most
+  transactions, but are required for Scheduled transactions, which are describe
+  below.  A transaction history, with category, can be shown for each payee.
 </para>
 </sect2>
 
@@ -299,9 +345,9 @@
 <title>Scheduled transactions</title>
 
 <para>
-  Where transactions occur on a regular basis, these can be set up against a
-  Schedule. Transactions are created from a schedule; any that are overdue can
-  be seen on the home page.
+  Where transactions occur on a regular basis, such as salary or utility bills, these
+  can be set up against a Schedule.  Transactions are created from Schedules.
+  Scheduled transaction which are overdue can be shown on the home page.
 </para>
 </sect2>
 </sect1>
@@ -309,74 +355,82 @@
 <sect1 id="makingmostof.usefultips">
 <title>Useful Tips</title>
 
+<para>
+  When you start &kmymoney;, the Home View, or Home Page, shows a high level overview
+  of your finances.  It is divided into several sections, and you can customize which
+  are displayed.  Along the left, there are icons for each of the major Views.  Each one is used
+  by &kmymoney; to present a different type of data for entry or reveiw.
+</para>
+
 <para>
   Unless you keep your money under your mattress or under the floorboards, you
   probably make use of one or more institutions where you have accounts, which
   may be in credit or debit. In order to familiarize yourself with the way
   &kmymoney; works, choose an account you want to track with &kmymoney; and
   select the <menuchoice><guimenu>File</guimenu><guimenuitem>New</guimenuitem>
-  </menuchoice> menu item in order to set up an account file.
+  </menuchoice> menu item in order to set up a data file.
 </para>
 
 <para>
-  If you have used another personal finance manager, you may be able to import
-  the data from it into &kmymoney;.
+  If you have used another personal finance manager, you may be able to import the
+  data from it into &kmymoney;.
 </para>
 
 <para>
-  If you have some regular receipts into or outgoings from this account, go to
-  Payee and enter the names of both the payers and the payees involved; then go
-  to Schedule and fill in a New Schedule for each recurring transaction. If you
-  haven't entered the payee or payer, &kmymoney; will offer you the opportunity
-  to do this in the middle of entering the schedule.
+  If you have some regular receipts into or outgoings from this account, you can go
+  to the Payees View and enter the names of both the payers and the payees involved;
+  then go to Scheduled Transactions View and fill in a New Schedule for each
+  recurring transaction. If you haven't entered the payee or payer, &kmymoney; will
+  offer you the opportunity to do this in the middle of entering the Schedule.
 </para>
 
 <para>
-  To add other new transactions go to Ledgers; you can add new payees and
-  categories in the middle of a transaction or by going to Payees or Categories
-  before entering the transaction.
+  To add other new transactions go to th Ledger view; you can add new payees and
+  categories while entering a transaction or by going to the Payees or Categories
+  View before entering the transaction.
 </para>
 
-<para>
-  You will probably find that the default Categories do not exactly match your
-  needs; you can easily delete ones you know you are never going to need and add
-  others that you need. But when you are entering a transaction, you only have
-  to type a few letters of a category and &kmymoney; will offer you a drop down
-  list of the matching categories from which to choose.
+<para> 
+  Depending on which option you chose when setting up the data file, you will
+  probably find that the default Categories do not exactly match your needs; you can
+  easily delete ones you know you are never going to need and add others that you
+  need. But when you are entering a transaction, you only have to type a few letters
+  of a category and &kmymoney; will offer you a drop down list of the matching
+  categories from which to choose.
 </para>
 
 <para>
   You can add different accounts managed by different institutions; the
-  preferred one will show when you open &kmymoney; but you can quickly switch to
+  preferred ones will show when you open &kmymoney; but you can quickly switch to
   any of the others.
 </para>
 
 <para>
-  When you make a payment, &kmymoney; will work out what the next check number
-  should be; delete this if you are not making a check payment or edit it if
-  the first check you enter is not check number 1. Alternatively, it is
-  possible to switch off auto-increment of check numbers.
+  When you make a payment, &kmymoney; will work out what the next check number should
+  be; delete this if you are not making a check payment or edit it if the first check
+  you enter is not check number 1. Alternatively, it is possible to switch off
+  auto-increment of check numbers.
 </para>
 
 <para>
-  Every so often you may get statements of your account from the institutions
-  you use; you can reconcile your &kmymoney; accounts against these statements
-  so that you have an accurate statement of the current state of your finances.
+  Every so often you may get statements of your account from the institutions you
+  use.  You can reconcile your &kmymoney; accounts against these statements so that
+  you know you have an accurate representation of the current state of your finances.
 </para>
 
 <para>
-  If you go to Reports, you will find several default reports; to customize
-  these, open one similar to the sort you prefer and then select 'New' (not
-  'Copy'); you can then customize this to your needs and mark it as a preferred
+  If you go to the Reports View, you will find several default reports.  To customize
+  these, open the one most similar to the sort you prefer and then select 'New' (not
+  'Copy'.)  You can then customize this to your needs and mark it as a preferred
   report if you wish.
 </para>
 
 <para>
-  Though &kmymoney; is not intended for use in a business context, if you are
-  running a business on your own and so do not need payroll functions, you will
-  probably find that &kmymoney; is sufficiently customizable to meet your needs
-  particularly as it comes with budgeting and forecasting features and you can
-  export your customized reports via CSV into other applications.
+  Though &kmymoney; is not intended for use in a business context, if you are running
+  a business on your own and so do not need payroll functions, you may find that
+  &kmymoney; is sufficiently customizable to meet your needs, particularly as it
+  comes with budgeting and forecasting features, and you can export your customized
+  reports via CSV into other applications.
 </para>
 </sect1>
 </chapter>
diff --git a/doc/whatsnew.docbook b/doc/whatsnew.docbook
index 7a8f5b99d..a948b1778 100644
--- a/doc/whatsnew.docbook
+++ b/doc/whatsnew.docbook
@@ -10,19 +10,22 @@
 <title>Bug fixes and enhancements to functionality</title>
 
 <para>
-  As with every release, the &kmymoney; development team continues to work hard
-  to make each version better and easier to use in every way.  Many bugs have
-  been fixed since the previous stable release of 5.1.4; several areas of the
-  program have seen functional enhancements; but the major noticeable change from
-  the 5.1 series of releases is in the ledger - more details below.
+  As with every release, the &kmymoney; development team continues to work hard to
+  make each version better and easier to use in every way.  Many bugs have been fixed
+  since the previous stable release of 5.1.4; several areas of the program have seen
+  functional enhancements; but the major noticeable changes from the 5.1 series of
+  releases are in the ledger - more details below.
 </para>
 
 <para>
   The conversion to using &kde-frameworks; was essentially complete in the 5.1.x
   releases, with much of that work behind the scenes and not directly visible to the
   end user.  The general look and feel should remain stable, although some minor
-  changes still occur.  The basic functionality of the program also remains the same,
-  aside from intentional improvements and additions.
+  changes may be noticable.  In addition, the team has begun to make changes to
+  support the eventual conversion to using Qt6 and KDE6 libraries, which will
+  eventually replace Qt5 and KDE5. With all these changes, the basic functionality of
+  the program remains the same, aside from intentional bug fixes, improvements, and
+  additions.
 </para>
 
 <para>
@@ -33,10 +36,13 @@
 </para>
 
 <para>
-  The 5.0.x and 5.1.x series included some changes needing adjustments on the
-  user's side, if they were upgrading from 4.8.x or an older version.  However,
-  we expect that most users have converted to 5.x by now.  Specifically, there
-  should be no adjustments needed by users converting from 5.1.x to 5.2.
+  The 5.0.x and 5.1.x series included some changes needing adjustments on the user's
+  side, if they were upgrading from 4.8.x or an older version.  However, we expect
+  that most users have converted to 5.x by now.  Specifically, there should be no
+  adjustments needed by users converting from 5.1.x to 5.2.  If for some reason, you
+  are still using &kmymoney; version 4, you are very strongly encouraged to upgrade,
+  as it is getting increasingly difficult for the team to provide any assistance for
+  very old version.
 </para>
 
 </sect1>
@@ -44,9 +50,9 @@
 <sect1>
 <title>Updates to this Handbook</title>
 <para>
-  This section used to talk about the lack of complete handbook update from 4.x
-  to 5.x.  The intent is that the handbook be fully updated for 5.2, so this
-  section should hopefully be able to be removed before release.
+  This section used to present some details related to the lack of a complete
+  handbook update from 4.x to 5.x.  The intent is that the handbook be fully updated
+  for 5.2, so this section should hopefully be able to be removed before release.
 </para>
 
 </sect1>


More information about the kde-doc-english mailing list