DOC-473: Enter review comments

Author: keharper

app/code/Magento/CompareListGraphQl/etc/schema.graphqls

@@ -1,7 +1,7 @@
 # Copyright © Magento, Inc. All rights reserved.
 # See COPYING.txt for license details.
 
-type ComparableItem @doc(description: "Defines an item in a compare list.") {
+type ComparableItem @doc(description: "Defines an object used to iterate through items for product comparisons.") {
     uid: ID! @doc(description: "The unique ID of an item in a compare list.")
     product: ProductInterface! @doc(description: "Details about a product in a compare list.")
     attributes: [ProductAttribute]! @doc(description: "An array of product attributes that can be used to compare products.")
@@ -17,7 +17,7 @@ type ComparableAttribute @doc(description: "Contains an attribute code that is u
     label: String! @doc(description: "The label of the attribute code.")
 }
 
-type CompareList @doc(description: "Contains an array of items in a compare list.") {
+type CompareList @doc(description: "Contains iterable information such as the array of items, the count, and attributes that represent the compare list.") {
     uid: ID! @doc(description: "The unique ID assigned to the compare list.")
     items: [ComparableItem] @doc(description: "An array of products to compare.")
     attributes: [ComparableAttribute] @doc(description: "An array of attributes that can be used for comparing products.")

app/code/Magento/CustomerDownloadableGraphQl/etc/schema.graphqls

@@ -10,9 +10,9 @@ type CustomerDownloadableProducts @doc(description: "Contains a list of download
 }
 
 type CustomerDownloadableProduct @doc(description: "Contains details about a single downloadable product.") {
-    order_increment_id: String @doc(description: "An incremental ID assigned to the item.")
+    order_increment_id: String @doc(description: "The unique ID assigned to the item.")
     date: String @doc(description: "The date and time the purchase was made.")
     status: String @doc(description: "Indicates when the product becomes available for download. Options are `Pending` and `Invoiced`.")
     download_url: String @doc(description: "The fully qualified URL to the download file.")
-    remaining_downloads: String @doc(description: "The number of times the customer can download the product.")
+    remaining_downloads: String @doc(description: "The remaining number of times the customer can download the product.")
 }

app/code/Magento/QuoteGraphQl/etc/schema.graphqls

@@ -21,7 +21,7 @@ type Mutation {
     setGuestEmailOnCart(input: SetGuestEmailOnCartInput @doc(description: "An input object that defines a guest email address.")): SetGuestEmailOnCartOutput @resolver(class: "Magento\\QuoteGraphQl\\Model\\Resolver\\SetGuestEmailOnCart") @doc(description:"Assign the email address of a guest to the cart.")
     setPaymentMethodAndPlaceOrder(input: SetPaymentMethodAndPlaceOrderInput): PlaceOrderOutput @deprecated(reason: "Should use setPaymentMethodOnCart and placeOrder mutations in single request.") @resolver(class: "\\Magento\\QuoteGraphQl\\Model\\Resolver\\SetPaymentAndPlaceOrder") @doc(description:"Set the cart payment method and convert the cart into an order.")
     mergeCarts(source_cart_id: String! @doc(description: "The guest's cart ID before they login."), destination_cart_id: String @doc(description: "The cart ID after the guest logs in.")): Cart! @doc(description:"Transfer the contents of a guest cart into the cart of a logged-in customer.") @resolver(class: "Magento\\QuoteGraphQl\\Model\\Resolver\\MergeCarts")
-    placeOrder(input: PlaceOrderInput @doc(description: "An input object that defines the shopper's cart IS.")): PlaceOrderOutput @resolver(class: "\\Magento\\QuoteGraphQl\\Model\\Resolver\\PlaceOrder") @doc(description:"Convert the quote into an order.")
+    placeOrder(input: PlaceOrderInput @doc(description: "An input object that defines the shopper's cart ID.")): PlaceOrderOutput @resolver(class: "\\Magento\\QuoteGraphQl\\Model\\Resolver\\PlaceOrder") @doc(description:"Convert the quote into an order.")
     addProductsToCart(cartId: String! @doc(description: "The cart ID of the shopper."), cartItems: [CartItemInput!]! @doc(description: "An array that defines the products to add to the cart.")): AddProductsToCartOutput @doc(description:"Add any type of product to the cart.") @resolver(class: "Magento\\QuoteGraphQl\\Model\\Resolver\\AddProductsToCart")
 }
 
@@ -360,7 +360,7 @@ type SelectedCustomizableOption @doc(description: "Identifies a customized produ
     sort_order: Int! @doc(description: "A value indicating the order to display this option.")
 }
 
-type SelectedCustomizableOptionValue @doc(description: "Identifies the value of theselected customized option.") {
+type SelectedCustomizableOptionValue @doc(description: "Identifies the value of the selected customized option.") {
     id: Int! @deprecated(reason: "Use `SelectedCustomizableOptionValue.customizable_option_value_uid` instead.")
     customizable_option_value_uid: ID! @doc(description: "The unique ID for a value object that corresponds to the object represented by the `customizable_option_uid` attribute.")
     label: String! @doc(description: "The display name of the selected value.")

app/code/Magento/SalesGraphQl/etc/schema.graphqls

@@ -15,7 +15,7 @@ type ReorderItemsOutput @doc(description:"Contains the cart and any errors after
 }
 
 type CheckoutUserInputError @doc(description:"An error encountered while adding an item to the cart."){
-    message: String! @doc(description: "A ocalized error message.")
+    message: String! @doc(description: "A localized error message.")
     path: [String]! @doc(description: "The path to the input field that caused an error. See the GraphQL specification about path errors for details: http://spec.graphql.org/draft/#sec-Errors")
     code: CheckoutUserInputErrorCodes! @doc(description: "An error code that is specific to Checkout.")
 }