[pve-devel] [PATCH docs 07/10] Rewrite Disk Health Monitoring

[Aaron Lauterer]

Polished phrasing

Signed-off-by: Aaron Lauterer <a.lauterer at proxmox.com>
---
 pve-disk-health-monitoring.adoc | 34 +++++++++++++++++----------------
 1 file changed, 18 insertions(+), 16 deletions(-)

diff --git a/pve-disk-health-monitoring.adoc b/pve-disk-health-monitoring.adoc
index 8ea9d5f..5b03c1c 100644
--- a/pve-disk-health-monitoring.adoc
+++ b/pve-disk-health-monitoring.adoc
@@ -4,19 +4,20 @@ ifdef::wiki[]
 :pve-toplevel:
 endif::wiki[]
 
-Although a robust and redundant storage is recommended,
-it can be very helpful to monitor the health of your local disks.
+Although a robust and redundant storage is recommended it id
+considered good practice to monitor the health of the local disks.
 
 Starting with {pve} 4.3, the package smartmontools footnote:[smartmontools homepage https://www.smartmontools.org]
-is installed and required. This is a set of tools to monitor and control
-the S.M.A.R.T. system for local hard disks.
+is installed. It is a set of tools to monitor and control the
+'S.M.A.R.T.' system for local hard disks.
+
+To get the status of a disk issue the following command:
 
-You can get the status of a disk by issuing the following command:
 ----
 # smartctl -a /dev/sdX
 ----
 
-where /dev/sdX is the path to one of your local disks.
+where `/dev/sdX` is the path to the disk in question.
 
 If the output says:
 
@@ -24,21 +25,22 @@ If the output says:
 SMART support is: Disabled
 ----
 
-you can enable it with the command:
+it can be enabled with the following command:
 
 ----
 # smartctl -s on /dev/sdX
 ----
 
-For more information on how to use smartctl, please see `man smartctl`.
+For more information on how to use smartctl, please see
+`man smartctl`.
 
-By default, smartmontools daemon smartd is active and enabled, and scans
-the disks under /dev/sdX and /dev/hdX every 30 minutes for errors and warnings, and sends an
-e-mail to root if it detects a problem.
+By default the daemon smartd is active and enabled. It scans the disks
+under `/dev/sdX` and `/dev/hdX` every 30 minutes. If warnings or
+errors are encountered an email to the `root at pam` user is sent.
 
-For more information about how to configure smartd, please see `man smartd` and
-`man smartd.conf`.
+For more information about how to configure smartd please see
+`man smartd` and `man smartd.conf`.
 
-If you use your hard disks with a hardware raid controller, there are most likely tools
-to monitor the disks in the raid array and the array itself. For more information about this,
-please refer to the vendor of your raid controller.
+If a hardware RAID controller is used there is a chance that tools are
+available to monitor the RAID and the disks in it. Please refer to the
+vendor of the RAID controller.
-- 
2.20.1