[office/skrooge] doc: Use "Editing" instead of Edition in doc

S Page null at kde.org
Wed Jun 3 02:36:19 BST 2020


Git commit aef07eae6880a10f38ad15aa7bca8ca85d0f3e85 by S Page.
Committed on 03/06/2020 at 01:36.
Pushed by spage into branch 'master'.

Use "Editing" instead of Edition in doc

Summary:
"Edition mode" and "fast edition" don't make sense in English.
I renamed two images to match the improved language.

Reviewers: smankowski, yurchor

Reviewed By: yurchor

Subscribers: yurchor, kde-doc-english

Tags: #documentation

Differential Revision: https://phabricator.kde.org/D29837

R  +-    --    doc/editing_panel_buttons.png [from: doc/edition_panel_buttons.png - 100% similarity]
R  +-    --    doc/fast_editing.png [from: doc/fast_edition.png - 100% similarity]
M  +24   -24   doc/index.docbook

https://invent.kde.org/office/skrooge/commit/aef07eae6880a10f38ad15aa7bca8ca85d0f3e85

diff --git a/doc/edition_panel_buttons.png b/doc/editing_panel_buttons.png
similarity index 100%
rename from doc/edition_panel_buttons.png
rename to doc/editing_panel_buttons.png
diff --git a/doc/fast_edition.png b/doc/fast_editing.png
similarity index 100%
rename from doc/fast_edition.png
rename to doc/fast_editing.png
diff --git a/doc/index.docbook b/doc/index.docbook
index c4bf857cf..fbd3b2a01 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -79,7 +79,7 @@
       <title>&skrooge;</title>
       
       <para>
-	&skrooge; is an application for managing your personal finances. It can keep track of your incomes and expenses across several accounts, in several currencies. It has all the features you should expect from such a tool, such as categories, scheduled operations, graphical reporting, stocks management... It also has some less common features, like fast operation edition, search as you type, refund trackers, customizable attributes...
+	&skrooge; is an application for managing your personal finances. It can keep track of your incomes and expenses across several accounts, in several currencies. It has all the features you should expect from such a tool, such as categories, scheduled operations, graphical reporting, stocks management... It also has some less common features, like fast operation editing, search as you type, refund trackers, customizable attributes...
       </para>
       
       <screenshot>
@@ -451,20 +451,20 @@
 	<para>&skrooge; can display several tabs. You can add as many tabs as you want, each one containing the information you need. The above screenshot shows 4 tabs (accounts, operations, and two graphs).</para>
       </sect2>
       
-      <sect2 id="edition_panels">
-	<title>Edition Panels</title>
-	<para>In most &skrooge; tabs, the way to edit items is to use the edition panel, located at the bottom of the page. In order to preserve maximum space for visualizing information, especially on small screens, edition panels can be hidden or displayed using buttons.</para>
+      <sect2 id="editing_panels">
+	<title>Editing Panels</title>
+	<para>In most &skrooge; views, you edit items in an editing panel located at the bottom of the page.</para>
 	
 	<screenshot>
 	  <mediaobject>
-	    <imageobject><imagedata fileref="edition_panel_buttons.png" format="PNG"/></imageobject>
-	    <textobject><phrase>Buttons for showing or hiding Operations edition panels.</phrase></textobject>
+	    <imageobject><imagedata fileref="editing_panel_buttons.png" format="PNG"/></imageobject>
+	    <textobject><phrase>Buttons for showing or hiding the Operations editing panel.</phrase></textobject>
 	  </mediaobject>
 	</screenshot>
 	
-	<para>When more than one edition mode is available, several buttons allow choosing amongst them. In the above screenshot, there are four buttons allowing to choose the edition mode for <link linkend="operations">Operations</link>, "Standard", "Split", "Transfer" and "Shares".</para>
+	<para>When a view has more than one editing mode, buttons let you choose among them. In the above screenshot, there are four buttons to choose different editing modes for <link linkend="operations">Operations</link>: "Standard", "Split", "Transfer" and "Shares". In order to preserve maximum space for visualizing information, especially on small screens, you can hide or show some views' editing panel. In the above screenshot, if you click the button for the current mode to deselect it, the editing panel hides.</para>
 	
-	<para>All numerical fields are interpreted. It means that you can enter mathematical expressions like this:
+	<para>In editing panels, all numerical fields are interpreted. This means that you can enter mathematical expressions such as:
 	  <itemizedlist>
 	    <listitem><para>5*3+10</para></listitem>
 	    <listitem><para>5*(3+10)</para></listitem>
@@ -1305,7 +1305,7 @@
       
       <sect2 id="create_account">
 	<title>Create an Account</title>
-	<para>The account creation is done using the edition panel below the accounts list.</para>
+	<para>You create accounts in the editing panel below the accounts list in Accounts view.</para>
 	
 	<para>
 	  To create an account, enter its attributes (the mandatory ones are in bold), and click on <guibutton>Add</guibutton>. &skrooge; doesn't need you to provide the initial amount of this account. In order to set the initial amount of the account, create an operation corresponding to the initial amount.</para>
@@ -1427,8 +1427,8 @@
       </sect2>
       
       <sect2 id="standard_operation">
-	<title>Create an operation</title>
-	<para>To create a standard operation, you may use the <guibutton>Clear button</guibutton> to clear all fields and start a new operation from scratch. You can then fill its attributes (manually or using <link linkend="fast_edition">fast edition</link>), and click on <guibutton>Add</guibutton>.</para>
+	<title>Create an Operation</title>
+	<para>To create a standard operation, you may use the <guibutton>Clear button</guibutton> to clear all fields and start a new operation from scratch. You can then fill its attributes (manually or using <link linkend="fast_editing">fast editing</link>), and click on <guibutton>Add</guibutton>.</para>
         <para>If the appropriate setting is enabled, then the category will be set automatically when the payee is set.</para>
 	<para>You may also select a similar operation from the existing operations, modify what needs to be changed, and then click on <guibutton>Add</guibutton>.</para>
       </sect2>
@@ -1436,12 +1436,12 @@
       
       <sect2 id="split_operation">
 	<title>Split Operation</title>
-	<para>A split operation is an operation that has several dates, categories, comments or trackers. You switch to the split operation edition mode using the <guibutton>Split Button</guibutton> at the bottom of &skrooge; window. When switching into the split operation edition mode, the fields Category, Comment and Tracker are replaced by a table.</para>
+	<para>A split operation is an operation that has several dates, categories, comments or trackers. You switch to the split operation editing mode using the <guibutton>Split Button</guibutton> at the bottom of the Operations view. When switching into the split operation editing mode, the fields Category, Comment and Tracker are replaced by a table.</para>
 	
 	<screenshot>
 	  <mediaobject>
 	    <imageobject><imagedata fileref="split_operation.png" format="PNG"/></imageobject>
-	    <textobject><phrase>The split operation edition panel.</phrase></textobject>
+	    <textobject><phrase>The split operation editing panel.</phrase></textobject>
 	  </mediaobject>
 	</screenshot>
 	
@@ -1449,7 +1449,7 @@
 	
 	<para>You can add as many lines in this table as you need. When changing the quantity in a line, &skrooge; will compute the difference with the operation global quantity, and display the remaining quantity in the last table line. If you changed the quantity in the last line, a new line will be added with the remaining quantity.</para>
 	
-	<para>The fields here have the same behaviour as in the standard operation edition mode:</para>
+	<para>The fields here have the same behaviour as in the standard operation editing mode:</para>
 	
 	<itemizedlist>
 	  <listitem><para>The split by Date is useful for example when you paid your sport training for 3 months. In this case, you can split the payment on 3 months, this will have an impact on reports.</para></listitem>
@@ -1466,7 +1466,7 @@
 	<screenshot>
 	  <mediaobject>
 	    <imageobject><imagedata fileref="transfer_operation.png" format="PNG"/></imageobject>
-	    <textobject><phrase>The transfer operation edition panel.</phrase></textobject>
+	    <textobject><phrase>The transfer operation editing panel.</phrase></textobject>
 	  </mediaobject>
 	</screenshot>
 	
@@ -1484,7 +1484,7 @@ file is opened. It is also recommended to create a different account (⪚ "ETF"
 	<screenshot>
 	  <mediaobject>
 	    <imageobject><imagedata fileref="shares.png" format="PNG"/></imageobject>
-	    <textobject><phrase>The shares edition panel.</phrase></textobject>
+	    <textobject><phrase>The shares editing panel.</phrase></textobject>
 	  </mediaobject>
 	</screenshot>
 	<itemizedlist>
@@ -1515,16 +1515,16 @@ file is opened. It is also recommended to create a different account (⪚ "ETF"
 	
       </sect2>
       
-      <sect2 id="fast_edition">
-	<title>Fast Edition</title>
+      <sect2 id="fast_editing">
+	<title>Fast Editing</title>
 	
-	<para>Whatever the chosen edition mode, there is a nifty function called Fast Edition that may speed up the work while creating new operations. It will fill the operation's attributes based on previously entered operations. Enter a value in any field of the editor, and press <keycap>F10</keycap>, or click on the <guibutton>Fast Edition Icon <inlinemediaobject><imageobject><imagedata fileref="fast_edition.png" format="PNG"/></imageobject></inlinemediaobject></guibutton> (without leaving the selected field).</para>
+	<para>Whatever editing mode you choose, there is a nifty function called Fast Editing that may speed up the work while creating new operations. It will fill the operation's attributes based on previously entered operations. Enter a value in any field of the editor, and press <keycap>F10</keycap>, or click on the <guibutton>Fast Editing Icon <inlinemediaobject><imageobject><imagedata fileref="fast_editing.png" format="PNG"/></imageobject></inlinemediaobject></guibutton> (without leaving the selected field).</para>
 	
-	<para>&skrooge; will look for the first (&ie; the most recent one) operation that has the same value in the same field, and fill all other fields with values from that operation. Call Fast Edition again, it will look for the next operation, and so on.</para>
+	<para>&skrooge; will look for the first (&ie; the most recent one) operation that has the same value in the same field, and fill all other fields with values from that operation. Call Fast Editing again, it will look for the next operation, and so on.</para>
 	
 	<warning>
-	  <para>Fast Edition has no effect on the date, since it is rather unlikely that you want to create exactly the same operation, complete with the same date...</para>
-	  <para>If you modified a field's value before calling Fast Edition, its content will not be affected. This is materialized by a different background color in the field, so you know it is "frozen".</para>
+	  <para>Fast Editing has no effect on the date, since it is rather unlikely that you want to create exactly the same operation, complete with the same date...</para>
+	  <para>If you modified a field's value before calling Fast Editing, its content will not be affected. This is materialized by a different background color in the field, so you know it is "frozen".</para>
 	</warning>
 	
 	<para>What's different here from similar functions in other personal finances software:</para>
@@ -1559,7 +1559,7 @@ file is opened. It is also recommended to create a different account (⪚ "ETF"
 	
 	<para>These running totals help you spot operations you may have forgotten to enter in &skrooge;. Many bank statements provide similar totals such as "Withdrawals" or "Deposits and Credits", although they may have separate totals for "Interest", "Fees". When the Delta is equal to 0, you <emphasis>may</emphasis> have pointed all operations matching the bank's record. For example, you may have mistakenly pointed a debit of 8€ and a credit of 2€, and overlooked a bank debit of 6€; the net is the same, minus 6€. When the Delta is 0, the <guibutton>Validate pointed operations button <inlinemediaobject><imageobject><imagedata fileref="validate.png" format="PNG" /></imageobject></inlinemediaobject></guibutton> is enabled. Click on this button to complete your reconciliation: all pointed operations are now checked.</para>
 	
-	<tip><para><inlinemediaobject><imageobject><imagedata fileref="fast_edition.png" format="PNG" /></imageobject></inlinemediaobject> can automatically point all imported operations for you.</para></tip>
+	<tip><para><inlinemediaobject><imageobject><imagedata fileref="fast_editing.png" format="PNG" /></imageobject></inlinemediaobject> can automatically point all imported operations for you.</para></tip>
 	
 	<para>If the option <guibutton>Hide checked operations</guibutton> for the table is selected from its "Show" menu (see <link linkend="show">Filter the table</link>), then all these operations will now be hidden.</para>
 	
@@ -2010,7 +2010,7 @@ file is opened. It is also recommended to create a different account (⪚ "ETF"
 	    </varlistentry>
 	    <varlistentry>
 	      <term>Values</term>
-	      <listitem><para>This edition mode allows to download unit values from Internet, or to manually enter a unit value at a given date.</para></listitem>
+	      <listitem><para>This editing mode allows to download unit values from Internet, or to manually enter a unit value at a given date.</para></listitem>
 	    </varlistentry>
 	  </variablelist>
 	</sect2>


More information about the kde-doc-english mailing list