DOC-475: Fix typos and make tweaks

Author: keharper

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

@@ -12,7 +12,7 @@ type CheckoutAgreement @doc(description: "Contains details about an individual c
     content_height: String @doc(description: "The height of the text box where the Terms and Conditions statement appears during checkout.")
     checkbox_text: String! @doc(description: "The checkbox text for the checkout agreement.")
     is_html: Boolean! @doc(description: "Indicates whether the `content` text is in HTML format.")
-    mode: CheckoutAgreementMode! @doc(description: "Whether agreements are accepted automatically or manually.")
+    mode: CheckoutAgreementMode! @doc(description: "Indicates whether agreements are accepted automatically or manually.")
 }
 
 enum CheckoutAgreementMode @doc(description: "Indicates how agreements are accepted.") {

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

@@ -10,9 +10,9 @@ type Query {
 type Currency {
     base_currency_code: String @doc(description: "The base currency set for the store, such as USD.")
     base_currency_symbol: String @doc(description: "The symbol for the specified base currency, such as $.")
-    default_display_currecy_code: String @deprecated(reason: "Field name is misspelled. Use `default_display_currency_code` instead.")
+    default_display_currecy_code: String @deprecated(reason: "The ield name is misspelled. Use `default_display_currency_code` instead.")
     default_display_currency_code: String @doc(description: "The currency that is displayed by default, such as USD.")
-    default_display_currecy_symbol: String @deprecated(reason: "Field name is misspelled. Use `default_display_currency_symbol` instead.")
+    default_display_currecy_symbol: String @deprecated(reason: "The field name is misspelled. Use `default_display_currency_symbol` instead.")
     default_display_currency_symbol: String @doc(description: "The currency symbol that is displayed by default, such as $.")
     available_currency_codes: [String] @doc(description: "An array of three-letter currency codes accepted by the store, such as USD and EUR.")
     exchange_rates: [ExchangeRate] @doc(description: "An array of exchange rates for currencies defined in the store.")

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

@@ -15,7 +15,7 @@ type Attribute @doc(description: "Contains details about the attribute, includin
     attribute_type: String @doc(description: "The data type of the attribute.")
     input_type: String @doc(description: "The frontend input type of the attribute.")
     attribute_options: [AttributeOption] @resolver(class: "Magento\\EavGraphQl\\Model\\Resolver\\AttributeOptions") @doc(description: "Attribute options list.")
-    storefront_properties: StorefrontProperties @doc(description: "Contains details about the storefront properties configured for the attribute.")
+    storefront_properties: StorefrontProperties @doc(description: "Details about the storefront properties configured for the attribute.")
 }
 
 type StorefrontProperties @doc(description: "Indicates where an attribute can be displayed.") {
@@ -26,7 +26,7 @@ type StorefrontProperties @doc(description: "Indicates where an attribute can be
     use_in_search_results_layered_navigation: Boolean @doc(description: "Indicates whether the attribute can be used in layered navigation on search results pages.")
 }
 
-enum UseInLayeredNavigationOptions @doc(description: "Defines whether the attribute filterable in layered navigation.") {
+enum UseInLayeredNavigationOptions @doc(description: "Defines whether the attribute is filterable in layered navigation.") {
     NO
     FILTERABLE_WITH_RESULTS
     FILTERABLE_NO_RESULT

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

@@ -2,7 +2,7 @@
 # See COPYING.txt for license details.
 
 type Mutation {
-    subscribeEmailToNewsletter(email: String! @doc(description: "The email address to subscribe.")): SubscribeEmailToNewsletterOutput @doc(description:"Subscribe the specified email to a newsletter") @resolver(class: "Magento\\NewsletterGraphQl\\Model\\Resolver\\SubscribeEmailToNewsletter")
+    subscribeEmailToNewsletter(email: String! @doc(description: "The email address to subscribe.")): SubscribeEmailToNewsletterOutput @doc(description:"Subscribe the specified email to the store's newsletter.") @resolver(class: "Magento\\NewsletterGraphQl\\Model\\Resolver\\SubscribeEmailToNewsletter")
 }
 
 type SubscribeEmailToNewsletterOutput @doc(description: "Contains the status of the request.") {

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

@@ -7,20 +7,20 @@ type Query {
 }
 
 type Mutation {
-    createPaypalExpressToken(input: PaypalExpressTokenInput! @doc(description: "An input object that defines the requirements to receive a payment token.")): PaypalExpressTokenOutput @resolver(class: "\\Magento\\PaypalGraphQl\\Model\\Resolver\\PaypalExpressToken") @doc(description:"Initiate an Express Checkout transaction and receives a token. Use this mutation for Express Checkout and Payments Standard payment methods.")
-    createPayflowProToken(input: PayflowProTokenInput! @doc(description: "An input object that defines the requirements to fetch payment token information.")): CreatePayflowProTokenOutput @resolver(class: "\\Magento\\PaypalGraphQl\\Model\\Resolver\\PayflowProToken") @doc(description: "Initiate a transaction and receives a token. Use this mutation for Payflow Pro and Payments Pro payment methods")
+    createPaypalExpressToken(input: PaypalExpressTokenInput! @doc(description: "An input object that defines the requirements to receive a payment token.")): PaypalExpressTokenOutput @resolver(class: "\\Magento\\PaypalGraphQl\\Model\\Resolver\\PaypalExpressToken") @doc(description:"Initiate an Express Checkout transaction and receive a token. Use this mutation for Express Checkout and Payments Standard payment methods.")
+    createPayflowProToken(input: PayflowProTokenInput! @doc(description: "An input object that defines the requirements to fetch payment token information.")): CreatePayflowProTokenOutput @resolver(class: "\\Magento\\PaypalGraphQl\\Model\\Resolver\\PayflowProToken") @doc(description: "Initiate a transaction and receive a token. Use this mutation for Payflow Pro and Payments Pro payment methods")
     handlePayflowProResponse(input: PayflowProResponseInput! @doc(description: "An input object that includes the payload returned by PayPal and the cart ID.")): PayflowProResponseOutput @resolver(class: "\\Magento\\PaypalGraphQl\\Model\\Resolver\\PayflowProResponse") @doc(description: "Handle a payment response and save the payment in Quote. Use this mutation for Payflow Pro and Payments Pro payment methods.")
 }
 
 input PaypalExpressTokenInput @doc(description: "Defines the attributes required to receive a payment token for Express Checkout and Payments Standard payment methods.") {
     cart_id: String! @doc(description:"The unique ID that identifies the customer's cart.")
     code: String! @doc(description:"The payment method code.")
-    urls: PaypalExpressUrlsInput! @doc(description:"A set of relative URLs that PayPal uses in response to various actions during the authorization process")
+    urls: PaypalExpressUrlsInput! @doc(description:"A set of relative URLs that PayPal uses in response to various actions during the authorization process.")
     use_paypal_credit: Boolean @doc(description: "Indicates whether the buyer clicked the PayPal credit button. The default value is false.")
     express_button: Boolean @doc(description: "Indicates whether the buyer selected the quick checkout button. The default value is false.")
 }
 
-type PaypalExpressToken @doc(description: "Deprecated: use `PaypalExpressTokenOutput` instead.") {
+type PaypalExpressToken @doc(description: "Deprecated. Use `PaypalExpressTokenOutput` instead.") {
     token: String @deprecated(reason: "Use `PaypalExpressTokenOutput.token` instead.") @doc(description:"The token returned by PayPal.")
     paypal_urls: PaypalExpressUrlList @deprecated(reason: "Use `PaypalExpressTokenOutput.paypal_urls` instead.") @doc(description:"A set of URLs that allow the buyer to authorize payment and adjust checkout details.")
 }
@@ -49,9 +49,9 @@ input PaymentMethodInput {
     paypal_express: PaypalExpressInput @doc(description:"Required input for Express Checkout and Payments Standard payments.")
     payflow_express: PayflowExpressInput @doc(description:"Required input for Payflow Express Checkout payments.")
     payflow_link: PayflowLinkInput @doc(description:"Required input for PayPal Payflow Link and Payments Advanced payments.")
-    payflowpro: PayflowProInput @doc(description: "Required input type for PayPal Payflow Pro and Payment Pro payments.")
+    payflowpro: PayflowProInput @doc(description: "Required input for PayPal Payflow Pro and Payment Pro payments.")
     hosted_pro: HostedProInput @doc(description:"Required input for PayPal Hosted pro payments.")
-    payflowpro_cc_vault: VaultTokenInput @doc(description:"Required input type for PayPal Payflow Pro vault payments.")
+    payflowpro_cc_vault: VaultTokenInput @doc(description:"Required input for PayPal Payflow Pro vault payments.")
 }
 
 input HostedProInput @doc(description:"Contains a set of relative URLs that PayPal uses in response to various actions during the authorization process. Magento prepends the base URL to this value to create a full URL. For example, if the full URL is https://www.example.com/path/to/page.html, the relative URL is path/to/page.html. Use this input for Payments Pro Hosted Solution payment method.") {
@@ -73,7 +73,7 @@ input PaypalExpressUrlsInput @doc(description:"Contains a set of relative URLs t
     return_url: String! @doc(description:"The relative URL of the final confirmation page that PayPal redirects to upon payment success. If the full URL to this page is https://www.example.com/paypal/action/return.html, the relative URL is paypal/action/return.html.")
     cancel_url: String! @doc(description:"The relative URL of the page that PayPal redirects to when the buyer cancels the transaction in order to choose a different payment method. If the full URL to this page is https://www.example.com/paypal/action/cancel.html, the relative URL is paypal/action/cancel.html.")
     success_url: String @doc(description:"The relative URL of the order confirmation page that PayPal redirects to when the payment is successful and additional confirmation is not needed. Not applicable to most PayPal solutions. If the full URL to this page is https://www.example.com/paypal/action/success.html, the relative URL is paypal/action/success.html.")
-    pending_url: String @doc(description:"The relative URL of the page that PayPal redirects to when the payment has been put on hold for additional review. This condition mostly applies to ACH transactions, and is not applicable to most PayPal solutions. If the full URL to this page is https://www.example.com/paypal/action/success_pending.html, the relative URL is paypal/action/success_pending.html. ")
+    pending_url: String @doc(description:"The relative URL of the page that PayPal redirects to when the payment has been put on hold for additional review. This condition mostly applies to ACH transactions, and is not applicable to most PayPal solutions. If the full URL to this page is https://www.example.com/paypal/action/success_pending.html, the relative URL is paypal/action/success_pending.html.")
 }
 
 type PaypalExpressUrlList @doc(description:"Contains a set of URLs that allow the buyer to authorize payment and adjust checkout details for Express Checkout and Payments Standard transactions.") {
@@ -91,7 +91,7 @@ input PayflowLinkTokenInput @doc(description:"Contains information required to f
     cart_id: String! @doc(description:"The unique ID that identifies the customer's cart.")
 }
 
-enum PayflowLinkMode @doc(description:"Mode for payment: TEST or LIVE. Applies to the Payflow Link and Payments Advanced payment methods.") {
+enum PayflowLinkMode @doc(description:"Indicates the mode for payment. Applies to the Payflow Link and Payments Advanced payment methods.") {
     TEST
     LIVE
 }

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

@@ -35,18 +35,18 @@ type Query {
 }
 
 type ProductReviewRatingsMetadata @doc(description: "Contains an array of metadata about each aspect of a product review.") {
-    items: [ProductReviewRatingMetadata!]! @doc(description: "List of product reviews sorted by position")
+    items: [ProductReviewRatingMetadata!]! @doc(description: "An array of product reviews sorted by position.")
 }
 
 type ProductReviewRatingMetadata @doc(description: "Contains details about a single aspect of a product review.") {
     id: String! @doc(description: "An encoded rating ID.")
-    name: String! @doc(description: "The label assigned to an aspect of a product that is being rated, such as quality or price")
+    name: String! @doc(description: "The label assigned to an aspect of a product that is being rated, such as quality or price.")
     values: [ProductReviewRatingValueMetadata!]! @doc(description: "List of product review ratings sorted by position.") @resolver(class: "Magento\\ReviewGraphQl\\Model\\Resolver\\ProductReviewRatingValueMetadata")
 }
 
 type ProductReviewRatingValueMetadata  @doc(description: "Contails details about a single value in a product review.") {
-    value_id: String! @doc(description: "An encoded rating value id.")
-    value: String! @doc(description: "A ratings scale, such as the number of stars awarded")
+    value_id: String! @doc(description: "An encoded rating value ID.")
+    value: String! @doc(description: "A ratings scale, such as the number of stars awarded.")
 }
 
 type Customer {

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

@@ -1,13 +1,13 @@
 # Copyright © Magento, Inc. All rights reserved.
 # See COPYING.txt for license details.
 type Query {
-    storeConfig : StoreConfig @resolver(class: "Magento\\StoreGraphQl\\Model\\Resolver\\StoreConfigResolver") @doc(description: "Returns details about the store's configuration.") @cache(cacheable: false)
+    storeConfig : StoreConfig @resolver(class: "Magento\\StoreGraphQl\\Model\\Resolver\\StoreConfigResolver") @doc(description: "Return details about the store's configuration.") @cache(cacheable: false)
     availableStores(
         useCurrentGroup: Boolean @doc(description: "Filter store views by the current store group.")
     ): [StoreConfig] @resolver(class: "Magento\\StoreGraphQl\\Model\\Resolver\\AvailableStoresResolver") @doc(description: "Get a list of available store views and their config information.")
 }
 
-type Website @doc(description: "Deprecated. It because should not be used on storefront. Contains information about a website.") {
+type Website @doc(description: "Deprecated. It should not be used on the storefront. Contains information about a website.") {
     id : Int @deprecated(reason: "The field should not be used on the storefront.") @doc(description: "The ID number assigned to the website.")
     name : String @deprecated(reason: "The field should not be used on the storefront.") @doc(description: "The website name. Websites use this name to identify it easier.")
     code : String @deprecated(reason: "The field should not be used on the storefront.") @doc(description: "A code assigned to the website to identify it.")
@@ -18,7 +18,7 @@ type Website @doc(description: "Deprecated. It because should not be used on sto
 
 type StoreConfig @doc(description: "Contains information about a store's configuration.") {
     id : Int @deprecated(reason: "Use `store_code` instead.") @doc(description: "The ID number assigned to the store.")
-    code : String @deprecated(reason: "Use `store_code` instead.") @doc(description: "A code assigned to the store to identify it")
+    code : String @deprecated(reason: "Use `store_code` instead.") @doc(description: "A code assigned to the store to identify it.")
     store_code: ID @doc(description: "The unique ID of the store view. In the Admin, this is called the Store View Code. When making a GraphQL call, assign this value to the `Store` header to provide the scope.")
     store_name : String @doc(description: "The label assigned to the store view.")
     store_sort_order : Int @doc(description: "The store view sort order.")
@@ -37,10 +37,10 @@ type StoreConfig @doc(description: "Contains information about a store's configu
     base_url : String @doc(description: "The store’s fully-qualified base URL.")
     base_link_url : String @doc(description: "A fully-qualified URL that is used to create relative links to the `base_url`.")
     base_static_url : String @doc(description: "The fully-qualified URL that specifies the location of static view files.")
-    base_media_url : String @doc(description: "The fully-qualified URL that specifies the location of user media files.")
+    base_media_url : String @doc(description: "The fully-qualified URL that specifies the location of media files.")
     secure_base_url : String @doc(description: "The store’s fully-qualified secure base URL.")
     secure_base_link_url : String @doc(description: "A secure fully-qualified URL that is used to create relative links to the `base_url`.")
     secure_base_static_url : String @doc(description: "The secure fully-qualified URL that specifies the location of static view files.")
-    secure_base_media_url : String @doc(description: "The secure fully-qualified URL that specifies the location of user media files.")
+    secure_base_media_url : String @doc(description: "The secure fully-qualified URL that specifies the location of media files.")
     use_store_in_url: Boolean @doc(description: "Indicates whether the store code should be used in the URL.")
 }

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

@@ -1,6 +1,6 @@
 # Copyright © Magento, Inc. All rights reserved.
 # See COPYING.txt for license details.
-type StoreConfig @doc(description: "The type contains information about a store config") {
+type StoreConfig {
     head_shortcut_icon : String @doc(description: "The small graphic image (favicon) that appears in the address bar and tab of the browser.")
     default_title : String @doc(description: "The title that appears at the title bar of each page when viewed in a browser.")
     title_prefix : String @doc(description: "A prefix that appears before the title to create a two- or three-part title.")