[pve-devel] [PATCH v4 docs 6/7] Overhaul System Software Updates

[Aaron Lauterer]

improve phrasing, align style of CLI commands

Signed-off-by: Aaron Lauterer <a.lauterer at proxmox.com>
---
v2 -> v3:
rebased on current master

v1 -> v2:
applied suggestions from oguz [0]

[0] https://pve.proxmox.com/pipermail/pve-devel/2019-September/038965.html

 system-software-updates.adoc | 25 ++++++++++---------------
 1 file changed, 10 insertions(+), 15 deletions(-)

diff --git a/system-software-updates.adoc b/system-software-updates.adoc
index 04c17f3..013e171 100644
--- a/system-software-updates.adoc
+++ b/system-software-updates.adoc
@@ -4,21 +4,16 @@ ifdef::wiki[]
 :pve-toplevel:
 endif::wiki[]
 
-We provide regular package updates on all repositories. You can
-install those update using the GUI, or you can directly run the CLI
-command `apt-get`:
+Proxmox provides updates on a regular basis for all repositories. To install
+updates use the web-based GUI or the following CLI commands:
 
- apt-get update
- apt-get dist-upgrade
+----
+# apt-get update
+# apt-get dist-upgrade
+----
 
-NOTE: The `apt` package management system is extremely flexible and
-provides countless of feature - see `man apt-get` or <<Hertzog13>> for
-additional information.
+NOTE: The APT package management system is very flexible and provides many
+features, see `man apt-get`, or <<Hertzog13>> for additional information.
 
-You should do such updates at regular intervals, or when we release
-versions with security related fixes. Major system upgrades are
-announced at the {forum}. Those announcement also contain detailed
-upgrade instructions.
-
-TIP: We recommend to run regular upgrades, because it is important to
-get the latest security updates.
+TIP: Regular updates are essential to get the latest patches and security
+related fixes. Major system upgrades are announced in the {forum}.
-- 
2.20.1