stats: some grammar layout and content additions/adaptions

note that much less changed that it seems from a line-based git use
git show --word-diff=color --word-diff-regex='\w+' to see actual
change.

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

diff --git a/pmg-statistic.adoc b/pmg-statistic.adoc
index 58e4d770611ca4f224882bd8a4d4a982c02df4dc..02ea81c8488bb569f9e2965e70768907ca18c1ca 100644 (file)
--- a/pmg-statistic.adoc
+++ b/pmg-statistic.adoc
@@ -1,13 +1,13 @@
 Statistics
 ==========
 
-{pmg} offers a useful and feature-rich statistics interface, which allows the
-administrators to quickly see the general workload and makes it easy to identify
-problems.
+{pmg} provides a useful and feature-rich statistics interface that allows
+administrators to quickly get an overview of the overall workload and easily
+identify problems.
 
-The statistics are shown for the selected time range, which defaults to the
-current day, but can be changed to any other day, a whole month, or even a
-whole year.
+The statistics are displayed for a selected period, which by default is the
+current day. This period can be changed to any other day, a whole month or even
+a whole year.
 
 On the main statistics page there are three graphs with additional data:
 
@@ -23,8 +23,8 @@ Shows the total mail flow as a graph and the following details:
 
 'Incoming Mails'::
 
-Shows the incoming mail counts as a graph and the following details
-(as counts and percentages of the incoming mail volume):
+Displays the count of incoming mails from each of the following categories,
+including their percentage of the total incoming mail volume:
 
 * Incoming Mails
 * Junk Mails (Virus + Spam + Greylisted + SPF rejects + RBL rejects)
@@ -36,8 +36,8 @@ Shows the incoming mail counts as a graph and the following details
 
 'Outgoing Mails'::
 
-Shows the outgoing mail counts as a graph and the following details
-(as counts and percentages of the outgoing mail volume):
+Displays the count of outgoing mails from each of the following categories,
+including their percentage of the total outgoing mail volume:
 
 * Outgoing Mails
 * Bounces (mails with an empty envelope-sender address)
@@ -46,20 +46,22 @@ Shows the outgoing mail counts as a graph and the following details
 Spam Scores
 -----------
 
-This panel shows the distribution of the different spam scores for the selected
-time frame.
+The `Spam Scores` panel shows the distribution of the different spam scores for
+the selected time period. Note that you can also select a whole month or even a
+whole year as period to display.
 
 Virus Charts
 ------------
 
-This panel shows which and how many viruses were detected in the selected
-time frame.
+The `Virus Charts` panel shows which and how many viruses were detected in the
+selected time period.
 
 Hourly Distribution
 -------------------
 
-Shows the amount of incoming and outgoing mail per hour for the selected
-time frame.
+The `Hourly Distribution` shows the amount of incoming and outgoing mail per
+hour for the selected time period. For periods spanning a whole month or a
+whole year the arithmetic average of mail volume in an hour will be shown.
 
 Postscreen
 ----------
@@ -71,16 +73,17 @@ https://www.postfix.org/POSTSCREEN_README.html[postscreen readme].
 Domain
 ------
 
-Contains a summary for the recipient domain of the incoming and outgoing mails
-of the selected time frame, with traffic, count, how many viruses were detected,
-and how much of it was spam.
+The `Domain` view is split into two tabs, one for incoming and one for outgoing
+mails. Each shows a summary grouped by the recipient domain in a selected time
+frame, with stats for traffic, count, how many viruses were detected, and how
+much of the mail volume was classified as spam.
 
 Sender
 ------
 
-This panel contains a list of e-mail addresses that sent mail out in the
-selected time frame, with a total count, how many viruses were detected and how
-big these mails were.
+The `Sender` panel contains a list of e-mail addresses that sent mail out in
+the selected time frame, with a total count, how many viruses were detected and
+how big these mails were.
 
 If you click on one of these e-mail addresses, you see a detailed list of
 recipients, complete with size, date and time.
@@ -95,9 +98,9 @@ as the total mail size.
 If you click an entry, it shows a detailed list of mails with size, date,
 time, virus and spam score info.
 
-If the `advanced statistics filters` are active, only active accounts will be
-listed. Active accounts are those which sent mail in the selected time frame
-or up to 90 days before.
+If the `Use advanced statistics filters` option (`Configurations -> Options`)
+is enabled, only active accounts will be listed. Active accounts are those that
+sent mail during the selected time period or up to 90 days before.
 
 Contact
 -------
@@ -107,7 +110,7 @@ This contains the list of external recipients that received mail from this
 
 If you click an entry, it shows a list of mails with size, date and time.
 
-If the `advanced statistics filters` are active, active accounts will be
-filtered out, since they can already be seen in the `Receiver` panel. Active
-accounts are those which sent mail in the selected time frame or up to 90 days
-before.
+If the `Use advanced statistics filters` option (`Configurations -> Options`)
+is enabled, active accounts will be filtered out, since they can already be
+seen in the `Receiver` panel.  Active accounts are those which sent mail in the
+selected time frame or up to 90 days before.