Addressed PR feedback

Author: Dorthu

src/data/endpoints/account.yaml

@@ -16,15 +16,15 @@ endpoints:
           Returns your account settings.
         examples:
           curl: |
-            curl -h "Authorization: Bearer $TOKEN" \
+            curl -H "Authorization: Bearer $TOKEN" \
                 https://$api_root/$version/account
       PUT:
         description: >
           Edits your account settings.
         examples:
           curl: |
-            curl -h "content-type: application/json" \
-                -h "authorization: bearer $token" \
+            curl -H "Content-Type: application/json" \
+                -H "Authorization: Bearer $TOKEN" \
                 -X PUT -d '{
                   "address_1": "123 Main St.",
                   "address_2": "Suite 101",
@@ -52,15 +52,15 @@ endpoints:
           Returns your current defaults.
         examples:
           curl: |
-            curl -h "Authorization: Bearer $TOKEN" \
+            curl -H "Authorization: Bearer $TOKEN" \
                 https://$api_root/$version/account/settings
       PUT:
         description: >
           Edits your account's defaults.
         examples:
           curl: |
-            curl -h "Content-Type: application/json" \
-                -h "Authorization: Bearer $TOKEn" \
+            curl -H "Content-Type: application/json" \
+                -H "Authorization: Bearer $TOKEN" \
                 -X PUT -d '{
                   "network_helper": true,
                   "longview_subscription": "longview-10"

src/data/objects/account.yaml

@@ -25,15 +25,17 @@ schema:
     value: Suite 101
   city:
     type: String
-    description: City portion of this account's billing address.
+    description: The city for this account's billing address.
     value: Philadelphia
   state:
     type: String
-    description: State (or province) portion of this account's billing address.
+    description: >
+      State portion of this account's billing address, or province if you
+      are outside of the United States.
     value: PA
   zip:
     type: String
-    description: Zip Code portion of this account's billing address.
+    description: The zip code for this account's billing address.
     value: 19102
   country:
     type: String