spelling and format updates

Author: kbrwn

coreupdate/coreupdate-aws-s3.md

@@ -1,4 +1,4 @@
-# Configure CoreUpdate to Serve Packages from AWS S3  
+# Configure CoreUpdate to serve packages from AWS S3  
 
 The [updateservicectl][updateservicectl] tool can be used to fetch Container Linux updates from upstream and push the update payload to AWS S3. This process is documented for a general file server at: [CoreUpdate - Air Gapped Package Management][airgap]
 
@@ -8,7 +8,7 @@ Download the update payload from the upstream public CoreUpdate instance. The co
 $ updateservicectl --server=https://public.update.core-os.net package download --dir=/packages/ --version=1632.2.1
 ```
 
-Now the /packages/ directory contains a json file with update metadata and the gzipped update payload:
+Now the /packages/ directory contains a JSON file with update metadata and the Gzipped update payload:
 
 ```
 $ tree packages 
@@ -19,15 +19,15 @@ packages
 0 directories, 2 files
 ```
 
-Use the `updateservicectl package create bulk` command to create the package on an CoreUpdate instance. In the example below, CoreUpdate is running at: `http://coreupdate.example.com:8000`. 
+Use the `updateservicectl package create bulk` command to create the package on a CoreUpdate instance. In the example below, CoreUpdate is running at: `http://coreupdate.example.com:8000`. 
 
 ```
 $ updateservicectl --server=http://coreupdate.example.com:8000 --user=admin --key=4025a24d-b1e4-4294-b0ca package create bulk --base-url=https://s3-us-west-1.amazonaws.com/core-update-support --dir=/packages
 ```
 
 Note the use of the flags `--user` and `--key` these will be required. Most often the user will be `admin` and the key can be found in the `/etc/coreupdate/config.yaml` file. 
 
-Be certain to format the URL passed to the `--base-url` flag as described in the AWS document: " [AWS S3 Regions and Endpoints][aws-endpoints]". 
+Be certain to format the URL passed to the `--base-url` flag as described in the AWS document: "[AWS S3 Regions and Endpoints][aws-endpoints]". 
 
 On successful creation of the package, the output of this command will state where to upload payloads:
 
@@ -37,7 +37,7 @@ On successful creation of the package, the output of this command will state whe
 2018/02/06 15:59:41 Please upload payloads to https://s3-us-west-1.amazonaws.com/core-update-support.
 ```
 
-Upload the update package to s3:
+Upload the update package to the S3 bucket:
 
 ```
 aws s3 cp /packages/e96281a6-d1af-4bde-9a0a-97b76e56dc57_1632.2.1_update.gz s3://core-update-support
@@ -51,8 +51,9 @@ curl -L https://s3-us-west-1.amazonaws.com/core-update-support/e96281a6-d1af-4bd
 
 Consult the document [CoreUpdate - Configure Machines][core-update-config] for details on configuring a Container Linux host to use CoreUpdate.
 
+
 [updateservicectl]: https://github.com/coreos/updateservicectl/releases
-[airgap]: https://coreos.com/products/coreupdate/docs/latest/on-premises-deployment.html#air-gapped-package-management
+[airgap]: on-premises-deployment.html#air-gapped-package-management
 [aws-endpoints]: https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
-[core-update-config]: https://coreos.com/products/coreupdate/docs/latest/configure-machines.html
+[core-update-config]: configure-machines.html