[pmg-devel] [PATCH pmg-docs 3/3] planning deployment - language fix-up

Dylan Whyte d.whyte at proxmox.com
Wed May 26 16:08:51 CEST 2021


Improve spelling, grammar, readability, etc.

Signed-off-by: Dylan Whyte <d.whyte at proxmox.com>
---
 pmg-planning-deployment.adoc | 76 ++++++++++++++++++------------------
 1 file changed, 37 insertions(+), 39 deletions(-)

diff --git a/pmg-planning-deployment.adoc b/pmg-planning-deployment.adoc
index 6d1ab9f..48c6909 100644
--- a/pmg-planning-deployment.adoc
+++ b/pmg-planning-deployment.adoc
@@ -2,7 +2,7 @@
 Planning for Deployment
 =======================
 
-Easy integration into existing email server architecture
+Easy Integration into Existing Email Server Architecture
 ---------------------------------------------------------
 
 In this sample configuration, your email traffic (SMTP) arrives on
@@ -10,15 +10,15 @@ the firewall and will be directly forwarded to your email server.
 
 image::images/2018_IT_infrastructure_without_Proxmox_Mail_Gateway_final_1024.png[]
 
-By using the {pmg}, all your email traffic is forwarded to the
-Proxmox Mail Gateway, which filters the email traffic and
-removes unwanted emails. You can manage incoming and outgoing mail
+By using {pmg}, all your email traffic is forwarded to
+the {pmg} instance, which filters the email traffic and
+removes unwanted emails. This allows you to manage incoming and outgoing mail
 traffic.
 
 image::images/2018_IT_infrastructure_with_Proxmox_Mail_Gateway_final_1024.png[]
 
 
-Filtering outgoing emails
+Filtering Outgoing Emails
 --------------------------
 
 Many email filtering solutions do not scan outgoing mails. In contrast, {pmg} is
@@ -26,32 +26,31 @@ designed to scan both incoming and outgoing emails. This has two major
 advantages:
 
 . {pmg} is able to detect viruses sent from an internal host. In many
-countries you are liable for sending viruses to other
+countries, you are liable for sending viruses to other
 people. The outgoing email scanning feature is an additional
 protection to avoid that.
 
 . {pmg} can gather statistics about outgoing emails too. Statistics
-about incoming emails looks nice, but they are quite
-useless. Consider two users, user-1 receives 10 emails from news
-portals and wrote 1 email to a person you never heard from. While
-user-2 receives 5 emails from a customer and sent 5 emails
-back. Which user do you consider more active? I am sure it's user-2,
-because he communicates with your customers. {pmg} advanced address
-statistics can show you this important information. A solution which
-does not scan outgoing email cannot do that.
-
-To enable outgoing email filtering you just need to send all outgoing
-emails through your {pmg} (usually by specifying Proxmox as
+about incoming emails may look nice, but they aren't necessarily helpful.
+Consider two users; user-1 receives 10 emails from news
+portals and writes 1 email to an unknown individual, while
+user-2 receives 5 emails from customers and sends 5 emails
+in return. With this information, user-2 can be considered as the more active
+user, because they communicate more with your customers. {pmg} advanced address
+statistics can show you this important information, whereas a solution which
+does not scan outgoing email cannot do this.
+
+To enable outgoing email filtering, you simply need to send all outgoing
+emails through your {pmg} (usually by specifying {pmg} as
 "smarthost" on your email server).
 
 [[firewall_settings]]
-Firewall settings
+Firewall Settings
 -----------------
 
-In order to pass email traffic to the {pmg} you need to allow traffic on the
-SMTP port. Our software uses the Network Time Protocol (NTP) for time
-synchronization, RAZOR, DNS, SSH, HTTP and port 8006 for the web-based
-management interface.
+In order to pass email traffic to {pmg}, you need to allow traffic on the
+SMTP port. Our software uses the Network Time Protocol (NTP), RAZOR, DNS, SSH,
+and HTTP, as well as port 8006 for the web-based management interface.
 
 [options="header"]
 |======
@@ -81,7 +80,7 @@ section xref:nmap[port scans]).
 System Requirements
 -------------------
 
-The {pmg} can run on dedicated server hardware or inside a virtual machine on
+{pmg} can run on dedicated server hardware or inside a virtual machine on
 any of the following platforms:
 
 * Proxmox VE (KVM)
@@ -98,12 +97,11 @@ any of the following platforms:
 
 * LXC container
 
-* and others supporting Debian Linux as guest OS
+* and others that support Debian Linux as a guest OS
 
 Please see https://www.proxmox.com for details.
 
-In order to get a benchmark from your hardware, just run 'pmgperf'
-after installation.
+To benchmark your hardware, run 'pmgperf' after installation.
 
 
 Minimum System Requirements
@@ -113,39 +111,39 @@ Minimum System Requirements
 
 * 2 GB RAM
 
-* bootable CD-ROM-drive or USB boot support
+* Bootable CD-ROM-drive or USB boot support
 
-* Monitor with a resolution of 1024x768 for the installation
+* Monitor with a minimum resolution of 1024x768 for the installation
 
 * Hard disk with at least 8 GB of disk space
 
-* Ethernet network interface card
+* Ethernet network interface card (NIC)
 
 
 Recommended System Requirements
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-* Multicore CPU: 64bit (Intel EMT64 or AMD64), +
-  for use as virtual machine activate Intel VT/AMD-V CPU flag
+* Multi-core CPU: 64bit (Intel EMT64 or AMD64), +
+** for use in a virtual machine, activate Intel VT/AMD-V CPU flag
 
 * 4 GB RAM
 
-* bootable CD-ROM-drive or USB boot support
+* Bootable CD-ROM-drive or USB boot support
 
-* Monitor with a resolution of 1024x768 for the installation
+* Monitor with a minimum resolution of 1024x768 for the installation
 
-* 1 Gbps Ethernet network interface card
+* 1 Gbps Ethernet network interface card (NIC)
 
-* Storage: at least 8 GB free disk space, best setup with redundancy,
-  use hardware RAID controller with battery backed write cache (``BBU'') or
-  ZFS. ZFS is not compatible with a hardware RAID controller. For best
-  performance use Enterprise class SSD with power loss protection.
+* Storage: at least 8 GB free disk space, best set up with redundancy,
+  using a hardware RAID controller with battery backed write cache (``BBU'') or
+  ZFS. ZFS is not compatible with hardware RAID controllers. For best
+  performance, use enterprise-class SSDs with power loss protection.
 
 
 Supported web browsers for accessing the web interface
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-To use the web interface you need a modern browser, this includes:
+To use the web interface, you need a modern browser. This includes:
 
 * Firefox, a release from the current year, or the latest Extended
 Support Release
-- 
2.20.1





More information about the pmg-devel mailing list