grammar updates v17 (#141)

* remove special chars

* grammar updates v17

* fix duplicate deploy instructions, commands

fix vm start command using old VM name, clean up duplicate deploy
instructions. Also add "first login" info with default credentials

docs/directpurchase.md

@@ -1,20 +1,20 @@
 # Direct purchase
 
-This is the simplest case: you buy XOA with your registered email account on `xen-orchestra.com`.
+This is the easiest purchase option: you can buy XOA with your registered email account on `xen-orchestra.com`.
 
 You can choose the edition you want in two places:
 
 * [the pricing page](https://xen-orchestra.com/#!/pricing)
-* [your account/member zone](https://xen-orchestra.com/#!/member)
+* [your account/member page](https://xen-orchestra.com/#!/member)
 
 
-> You need to be logged to make a purchase. If you don't have any account, please [register here](https://xen-orchestra.com/#!/signup).
+> You need to be logged to make a purchase. If you don't have an account, please [register here](https://xen-orchestra.com/#!/signup).
 
-From your account zone, click on the purchase menu, then select the edition you need:
+From your account page, click on the purchase menu, then select the edition you need:
 
 ![](./assets/directpurchase.png)
 
-Then you need to fill your information and select **"buy it for my own use"**:
+Then you need to fill in your information and select **"buy it for my own use"**:
 
 ![](./assets/member_purchase_2.png)
 
@@ -24,4 +24,4 @@ The default payment method is by **credit card**. But you can also choose the "w
 
 ## Wire transfer process
 
-If you selected wire transfer, you need to upload a transfer proof before we can unlock your XOA. If you don't, you'll have to wait for funds to be actually transferred in our account.
+If you select wire transfer, you need to upload a proof of transfer before we can unlock your XOA. If you don't, you'll have to wait for funds to actually be transferred into our account.

docs/editions.md

@@ -1,49 +1,49 @@
 # Editions
 
-There is 4 **editions** of Xen Orchestra Appliance (XOA):
+There are 4 **editions** of the Xen Orchestra Appliance (XOA):
 
 * Free
 * Starter
 * Enterprise
 * Premium
 
-**Also, you can try all features in the Premium Edition for free (without any commitment) for 15 days by registering on the trial. [Read here on how to do it](trial.md).**
+**Also, you can try all features in the Premium Edition for free (without any commitment) for 15 days by registering a trial. [Read here for trial instructions](trial.md).**
 
 ### Free
 
-This is a basic edition, allowing you to do administrator tasks on a virtualized infrastructure. It's "like" XenCenter. You can:
+This is the basic edition, allowing you to perform administrator tasks on a virtualized infrastructure. It's "like" XenCenter. You can:
 
 * Create VMs, SRs etc.
-* Access to web consoles
+* Access to VM consoles (HTML5 web based!)
 * Edit resources (VM, pools etc.)
 * Make snapshots
 * Migrate VMs
 
-That's more or less features what you can see in the [administration page](administration.md).
+That's more or less the same features you can see on the [administration page](administration.md).
 
 ### Starter
 
-Starter Edition is intended to system administrators who want to make more with their current XenServer infrastructure. This version is also bundled with our pro support!
+The Starter Edition is intended for system administrators who want to do more with their current XenServer infrastructure. This version is also bundled with our pro support!
 
-You got, in extra from the Free Edition:
+In addition to the free edition, you get:
 
 * [Scheduled backups](full_backups.md)
 * [Scheduled snapshots](rolling_snapshots.md)
-* Patch detection and application in one click
+* Patch detection and application in one click (even to whole pools at once!)
 * XenServer Docker management via XenServer plugin
 
-You'll also have access to our ticket system to report issue and be helped in less than 72h.
+You'll also have access to our ticket system to report issues and be helped in less than 72h.
 
 ### Enterprise
 
-Enterprise Edition allows you to access a lot more features than Starter:
+The Enterprise Edition allows you to access a lot more features than Starter:
 
 * Disaster Recovery
 * Continuous Delta Backup
 * Live stats
 * ACLs + LDAP/SSO
 
-In addition, you'll have faster support to answer your issues/questions.
+In addition, you'll have faster support to answer your issues/questions (48h or less).
 
 ### Premium
 
@@ -53,4 +53,6 @@ Premium is the highest edition, with all features included without any limitatio
 * Infrastructure health check
 * Job Manager
 * Continuous Replication
-* Self Service
+* Self Service
+
+Along with the fastest guaranteed support - 24 hours or less (typically much less).

docs/reseller.md

@@ -2,34 +2,34 @@
 
 The Xen Orchestra partner program is designed to offer you the opportunity to become a reseller of Xen Orchestra and deliver a full stack solution to your customers. 
 
-> Becoming a reseller will grant you a standard discount. However, **the reseller status is designed for companies that want to actively prospect for new Xen Orchestra users**. That's why we are asking our partners to **resell Xen Orchestra at least two time a year**. If you are acting as a third party purchaser answering to a specific request from one of your customer, you don't need to apply to the reseller program - you can follow [this process](https://xen-orchestra.com/docs/through_purchase_department.html) instead. 
+> Becoming a reseller will grant you a standard discount. However, **the reseller status is designed for companies that want to actively prospect for new Xen Orchestra users**. That's why we are asking our partners to **resell Xen Orchestra at least two times a year**. If you are acting as a third party purchaser answering to a specific request from one of your customers, you don't need to apply to the reseller program - you can follow [this process](https://xen-orchestra.com/docs/through_purchase_department.html) instead. 
 
 ## Apply to the program
 
-To apply to our partner program, you can go on the [partner page](https://xen-orchestra.com/#!/partner) and click on the "Register to become a partner" button:
+To apply to our partner program, you can access the [partner page](https://xen-orchestra.com/#!/partner) and click on the "Register to become a partner" button:
 
 ![](./assets/partner_request.png)
 
-You will have to complete a form in order to give us some informations regarding your expectation and location. Once it's down, you should receive an email in order to **start the discussion with someone from our team**.
+You will have to complete a form in order to provide information regarding your expectations and location. Once you've finished, you should receive an email in order to **start the discussion with someone from our team**.
 
-> It's important to answer the email in order to start the discussion with someone from our team in order to determine together if the partner status is what you really need.
+> It's important to answer the email - this will start the discussion with someone from our team in order to determine together if the partner status is what you really need.
 
 Once we have activated your partner space, you will have the ability to access the purchasing page [at the same place](https://xen-orchestra.com/#!/partner).
 
 ## Purchase XOAs
 
-Now that you could see the reseller interface:
+Now that you can see the reseller interface:
 
 ![](./assets/purchasing-process.png)
 
-You can follow these steps to purchase a XOA edition for your customer. 
+You can follow these steps to purchase an XOA edition for your customer. 
 
 1. choose the edition you want to purchase for your customer
-2. Buy it on your reseller space (the discount is automatically applied - once it's done, a new line appears on your reseller space)
+2. Buy it on your reseller page (the discount is automatically applied - once it's done, a new line appears on your reseller page)
 3. assign/bind the plan to your final client email
 
 You'll have all the invoices in your account.
 
-## From your client perspective
+## From your client's perspective
 
-Your client can use the email assigned to register its appliance, and unlock the Edition you purchased. He will not get any invoice from us but can still access to our support system.
+Your client can use the email assigned to register their appliance, and unlock the Edition you purchased. They will not get any invoices from us but can still access our support system.

docs/through_purchase_department.md

@@ -1,15 +1,15 @@
 # Through purchase department
 
-If you can't purchase for your own account, because you need to go through a dedicated purchase department in your company, this is the process you need to follow.
+If you can't purchase using your own account, usually because you need to go through a dedicated purchase department in your company, this is the process you need to follow.
 
-In means, there will be:
+Typically, you will provide two contacts:
 
-* a "billing contact" (in general, the purchaser email). This account will have access to invoices. And this is the account which make the purchase and then bind the XO plan for another one.
-* a "technical contact", the email of the system administrator using the solution and making support requests.
+* The "billing contact" (in general, the purchaser email). This account will have access to invoices. This is the account which makes the purchase and then binds the XO plan to the second contact account, the technical contact.
+* The "technical contact", the email of the system administrator using the solution and making support requests.
 
 ## As "billing contact"
 
-1. First of all, you need to create an account as a purchaser (eg: "purchase.dept@example.com"). Once it's done, you need to go inside the member zone, in the **purchases** menu.
+1. First of all, you need to create an account as a purchaser (eg: "purchase.dept@example.com"). Once it's done, you need to go inside the member page, in the **purchases** menu.
 
 
 ![](./assets/purchase-menu.jpg)
@@ -22,11 +22,11 @@ Now, you just have to pick the edition of Xen Orchestra you want to purchase for
 
 ![](./assets/purchase-for-another.png)
 
-3. Once the payment is completed, you will have to bind the plan with the end-user account. If the end-user doesn't have an account yet, the system will create one and send an e-mail to your end user. 
+3. Once the payment is completed, you will have to bind the plan with the end-user account (technical contact). If the end-user doesn't have an account yet, the system will create one and send an e-mail to your end user. 
 
 
 ![](./assets/bind-process.png)
 
 That's it, you have now completed the purchase. 
 
-**Once you have bind the plan to your end user account, you cannot change it. Double check the spelling of the e-mail before binding the account.**
+**Once you have bound the plan to your end user account, you cannot change it. Double check the spelling of the e-mail before binding the account.**

docs/xoa.md

@@ -1,43 +1,35 @@
-
 # XOA
 
-The fastest way to install Xen Orchestra is to use our Appliance. You can deploy it by connecting to your XenServer host and executing this:
-
-```
-bash -c "$(curl -s http://xoa.io/deploy)"
-```
-
-> This won't write or modify anything on your XenServer host: it will just import the XOA VM into your default storage repository.
-
-XOA is a Debian VM with:
+XOA is the Xen Orchestra Appliance. XOA is a Debian VM with:
 
 * Xen Orchestra already installed (nothing to do!)
 * Tested with all bundled dependencies (QA)
 * The web updater (update in one click)
-* Support (+SSH support, tooling…)
+* Support (+SSH support, tooling)
 * Secured system (sudo, firewall)
 
 ## Specifications
 
-By default, this VM is configured with:
+By default, the VM is configured with:
 
 * 2 vCPUs
 * 2GB of RAM
 * 15GB of disk (10GB for `/` and 5GB for `/var`)
 
-For usage on huge infrastructure (more than 500+ VMs), feel free to increase the RAM.
+For use on huge infrastructure (more than 500+ VMs), feel free to increase the RAM.
 
 ## Deployment
 
 ### The quickest way
 
-SSH to your XenServer, and execute the following:
+The fastest way to install Xen Orchestra is to use our appliance deploy script. You can deploy it by connecting to your XenServer host and executing the following:
 
 ```
 bash -c "$(curl -s http://xoa.io/deploy)"
 ```
+**Note:** This won't write or modify anything on your XenServer host: it will just import the XOA VM into your default storage repository.  
 
-Then follow the instructions:
+Now follow the instructions:
 
 * Your IP configuration will be requested: it's set to **DHCP by default**, otherwise you can enter a fixed IP address (eg `192.168.0.10`)
 * If DHCP is selected, the script will continue automatically. Otherwise a netmask, gateway, and DNS should be provided.
@@ -47,7 +39,16 @@ Then follow the instructions:
 
 Download XOA from xen-orchestra.com. Once you've got the XVA file, you can import it with `xe vm-import filename=xoa_unified.xva` or via XenCenter.
 
-After the VM is imported, you just need to start it with `xe vm-start vm="XOA Unified"` or with XenCenter.
+After the VM is imported, you just need to start it with `xe vm-start vm="XOA"` or with XenCenter.
+
+## First Login
+Once you have started the VM, you can access the web UI by putting the IP you configured during deployment into your web browser. If you did not configure an IP or are unsure, try one of the following methods to find it:  
+
+* Run `xe vm-list params=name-label,networks | grep -A 1 XOA` on your host
+* Check your router's DHCP leases for an `xoa` lease
+
+**Note:** The default Web UI credentials are `admin@admin.net` / `admin`
+
 
 ## Registration
 
@@ -139,7 +140,7 @@ $ xoa network static
 ? IP of the DNS server 192.168.100.254
 ```
 
-Xen Orchestra is now accessible in your browser on ` https://your-vm-ip`.
+Xen Orchestra is now accessible in your browser at ` https://your-vm-ip`.
 
 You can access the VM console through XenCenter or using VNC through a SSH tunnel.