GraphQL: Migrate Quote endpoint topics (#5284)

* first draft

* add redirect and related topics

* review comments

* fix broken link

Author: keharper

_data/toc/graphql.yml

@@ -47,6 +47,9 @@ pages:
 
     - label: Queries
       children:
+        - label: cart query
+          url: /graphql/queries/cart.html
+
         - label: category query
           url: /graphql/queries/category.html
 
@@ -89,6 +92,9 @@ pages:
         - label: getPayflowLinkToken query
           url: /graphql/queries/get-payflow-link-token.html
 
+        - label: giftCardAccount query
+          url: /graphql/queries/giftcard-account.html
+
         - label: isEmailAvailable query
           url: /graphql/queries/is-email-available.html
 
@@ -109,6 +115,18 @@ pages:
         - label: addConfigurableProductsToCart mutation
           url: /graphql/mutations/add-configurable-products.html
 
+        - label: addSimpleProductsToCart mutation
+          url: /graphql/mutations/add-simple-products.html
+
+        - label: addVirtualProductsToCart mutation
+          url: /graphql/mutations/add-virtual-products.html
+
+        - label: applyGiftCardToCart mutation
+          url: /graphql/mutations/apply-giftcard.html
+
+        - label: applyCouponToCart mutation
+          url: /graphql/mutations/apply-coupon.html
+
         - label: applyStoreCreditToCart mutation
           url: /graphql/mutations/apply-store-credit.html
 
@@ -121,6 +139,9 @@ pages:
         - label: createCustomer mutation
           url: /graphql/mutations/create-customer.html
 
+        - label: createEmptyCart mutation
+          url: /graphql/mutations/create-empty-cart.html
+
         - label: createPayflowProToken mutation
           url: /graphql/mutations/create-payflow-pro-token.html
 
@@ -136,21 +157,51 @@ pages:
         - label: handlePayflowProResponse mutation
           url: /graphql/mutations/handle-payflow-pro-response.html
 
+        - label: placeOrder mutation
+          url: /graphql/mutations/place-order.html
+
         - label: redeemGiftCardBalanceAsStoreCredit mutation
           url: /graphql/mutations/redeem-giftcard-balance.html
 
+        - label: removeCouponFromCart mutation
+          url: /graphql/mutations/remove-coupon.html
+
         - label: removeGiftCardFromCart mutation
           url: /graphql/mutations/remove-giftcard.html
 
+        - label: removeItemFromCart mutation
+          url: /graphql/mutations/remove-item.html
+
         - label: removeStoreCreditFromCart mutation
           url: /graphql/mutations/remove-store-credit.html
 
         - label: revokeCustomerToken mutation
           url: /graphql/mutations/revoke-customer-token.html
 
+        - label: setBillingAddressesOnCart mutation
+          url: /graphql/mutations/set-billing-address.html
+
+        - label: setGuestEmailOnCart mutation
+          url: /graphql/mutations/set-guest-email.html
+
+        - label: setPaymentMethodOnCart mutation
+          url: /graphql/mutations/set-payment-method.html
+
+        - label: setPaymentMethodAndPlaceOrder mutation
+          url: /graphql/mutations/set-payment-place-order.html
+
+        - label: setShippingAddressesOnCart mutation
+          url: /graphql/mutations/set-shipping-address.html
+
+        - label: setShippingMethodsOnCart mutation
+          url: /graphql/mutations/set-shipping-method.html
+
         - label: updateCustomerAddress mutation
           url: /graphql/mutations/update-customer-address.html
 
+        - label: updateCartItems mutation
+          url: /graphql/mutations/update-cart-items.html
+
         - label: updateCustomer mutation
           url: /graphql/mutations/update-customer.html
 
@@ -177,60 +228,6 @@ pages:
         - label: GroupedProduct data types
           url: /graphql/product/grouped-product.html
 
-    - label: Reference
-      children:
-            - label: Quote endpoint (cart query)
-              url: /graphql/reference/quote.html
-              children:
-
-                - label: addSimpleProductsToCart mutation
-                  url: /graphql/reference/quote-add-simple-products.html
-
-                - label: addVirtualProductsToCart mutation
-                  url: /graphql/reference/quote-add-virtual-products.html
-
-                - label: applyCouponToCart mutation
-                  url: /graphql/reference/quote-apply-coupon.html
-
-                - label: applyGiftCardToCart mutation
-                  url: /graphql/reference/quote-apply-giftcard.html
-
-                - label: createEmptyCart mutation
-                  url: /graphql/reference/quote-create-cart.html
-
-                - label: giftCardAccount query
-                  url: /graphql/reference/quote-giftcard-account.html
-
-                - label: placeOrder mutation
-                  url: /graphql/reference/quote-place-order.html
-
-                - label: removeCouponFromCart mutation
-                  url: /graphql/reference/quote-remove-coupon.html
-
-                - label: removeItemFromCart mutation
-                  url: /graphql/reference/quote-remove-item.html
-
-                - label: setBillingAddressesOnCart mutation
-                  url: /graphql/reference/quote-set-billing-address.html
-
-                - label: setGuestEmailOnCart mutation
-                  url: /graphql/reference/quote-set-guest-email.html
-
-                - label: setPaymentMethodOnCart mutation
-                  url: /graphql/reference/quote-payment-method.html
-
-                - label: setPaymentMethodAndPlaceOrder mutation
-                  url: /graphql/reference/quote-set-payment-place-order.html
-
-                - label: setShippingAddressesOnCart mutation
-                  url: /graphql/reference/quote-set-shipping-address.html
-
-                - label: setShippingMethodsOnCart mutation
-                  url: /graphql/reference/quote-shipping-method.html
-
-                - label: updateCartItems mutation
-                  url: /graphql/reference/quote-update-cart-items.html
-
     - label: Payment methods
       children:
 

_data/whats-new.yml

@@ -451,8 +451,8 @@ entries:
   type: Major update
   date: June 22, 2019
   link: https://github.com/magento/devdocs/pull/4556
-- description: The [GraphQL quote endpoint](https://devdocs.magento.com/guides/v2.3/graphql/reference/quote.html)
-    adds numerous mutations for 2.3.2. Each mutation is documented separately. The
+- description: The [GraphQL cart query](https://devdocs.magento.com/guides/v2.3/graphql/queries/cart.html)
+    now has numerous related mutations for 2.3.2. Each mutation is documented separately. The
     [GraphQL release notes](https://devdocs.magento.com/guides/v2.3/graphql/release-notes.html)
     lists these new mutations.
   versions: 2.3.2
@@ -1051,7 +1051,7 @@ entries:
   type: Major update
   date: March 26, 2019
   link: https://github.com/magento/devdocs/pull/3859
-- description: Added queries and mutations to the [quote endpoint](https://devdocs.magento.com/guides/v2.3/graphql/reference/quote.html)
+- description: Added the [`cart` query](https://devdocs.magento.com/guides/v2.3/graphql/queries/cart.html) and several mutations.
   versions: 2.3.1
   type: Major update
   date: March 26, 2019
@@ -1609,7 +1609,7 @@ entries:
   versions: 2.1.x, 2.2.x, 2.3.x
   type: Major update
   date: November 21 2018
-- description: Added the [GraphQL quote endpoint](https://devdocs.magento.com/guides/v2.3/graphql/reference/quote.html)
+- description: Added the [GraphQL cart query](https://devdocs.magento.com/guides/v2.3/graphql/queries/cart.html)
     topic
   versions: 2.3.x
   type: New topic

_includes/graphql/cart-object.md

@@ -11,12 +11,12 @@ Attribute |  Data Type | Description
 `selected_payment_method` | [SelectedPaymentMethod][SelectedPaymentMethod] | Selected payment method
 `shipping_addresses` | [ShippingCartAddress][ShippingCartAddress] | Contains one or more shipping addresses
 
-[AppliedCoupon]: {{page.baseurl}}/graphql/reference/quote.html#AppliedCoupon
-[AppliedGiftCard]: {{page.baseurl}}/graphql/reference/quote.html#AppliedGiftCard
-[AppliedStoreCredit]: {{page.baseurl}}/graphql/reference/quote.html#AppliedStoreCredit
-[AvailablePaymentMethod]: {{page.baseurl}}/graphql/reference/quote.html#AvailablePaymentMethod
-[BillingCartAddress]: {{page.baseurl}}/graphql/reference/quote.html#BillingCartAddress
-[CartItemInterface]: {{page.baseurl}}/graphql/reference/quote.html#CartItemInterface
-[CartPrices]: {{page.baseurl}}/graphql/reference/quote.html#CartPrices
-[SelectedPaymentMethod]: {{page.baseurl}}/graphql/reference/quote.html#SelectedPaymentMethod
-[ShippingCartAddress]: {{page.baseurl}}/graphql/reference/quote.html#ShippingCartAddress
+[AppliedCoupon]: {{page.baseurl}}/graphql/queries/cart.html#AppliedCoupon
+[AppliedGiftCard]: {{page.baseurl}}/graphql/queries/cart.html#AppliedGiftCard
+[AppliedStoreCredit]: {{page.baseurl}}/graphql/queries/cart.html#AppliedStoreCredit
+[AvailablePaymentMethod]: {{page.baseurl}}/graphql/queries/cart.html#AvailablePaymentMethod
+[BillingCartAddress]: {{page.baseurl}}/graphql/queries/cart.html#BillingCartAddress
+[CartItemInterface]: {{page.baseurl}}/graphql/queries/cart.html#CartItemInterface
+[CartPrices]: {{page.baseurl}}/graphql/queries/cart.html#CartPrices
+[SelectedPaymentMethod]: {{page.baseurl}}/graphql/queries/cart.html#SelectedPaymentMethod
+[ShippingCartAddress]: {{page.baseurl}}/graphql/queries/cart.html#ShippingCartAddress

_includes/graphql/payment-methods/hosted-pro-workflow.md

@@ -1,21 +1,21 @@
-1. The PWA client uses the [`setPaymentMethodOnCart`]({{page.baseurl}}/graphql/reference/quote-payment-method.html) mutation to set the payment method.
+1. The PWA client uses the [`setPaymentMethodOnCart`]({{page.baseurl}}/graphql/mutations/set-payment-method.html) mutation to set the payment method.
 
 1. The mutation returns a `Cart` object.
 
-1. The client runs the [`placeOrder`]({{page.baseurl}}/graphql/reference/quote-place-order.html) mutation, which creates an order in Magento and begins the authorization process.
+1. The client runs the [`placeOrder`]({{page.baseurl}}/graphql/mutations/place-order.html) mutation, which creates an order in Magento and begins the authorization process.
 
-2. Magento sends information about the order to PayPal and requests a secure URL that the PWA client will later use to connect to PayPal.
+1. Magento sends information about the order to PayPal and requests a secure URL that the PWA client will later use to connect to PayPal.
 
-3. PayPal's response includes the secure URL.
+1. PayPal's response includes the secure URL.
 
-4. The `placeOrder` mutation returns an order ID. The order has the status `payment pending`.
+1. The `placeOrder` mutation returns an order ID. The order has the status `payment pending`.
 
-5. The client runs the [`getHostedProUrl`]({{page.baseurl}}/graphql/queries/get-hosted-pro-url.html) query to retrieve the secure URL.
+1. The client runs the [`getHostedProUrl`]({{page.baseurl}}/graphql/queries/get-hosted-pro-url.html) query to retrieve the secure URL.
 
-6. Magento returns the secure URL in the `secure_form_url` attribute.
+1. Magento returns the secure URL in the `secure_form_url` attribute.
 
-7. The PWA client displays a payment form in an iframe rendered from the secure URL. When the customer completes the form, the client sends the payment information directly to the PayPal gateway, bypassing the Magento server.
+1. The PWA client displays a payment form in an iframe rendered from the secure URL. When the customer completes the form, the client sends the payment information directly to the PayPal gateway, bypassing the Magento server.
 
-8. After PayPal processes the payment, the gateway runs a silent post request against the Magento server. As a result, Magento sets the order status to processing, and the order is ready to be invoiced.
+1. After PayPal processes the payment, the gateway runs a silent post request against the Magento server. As a result, Magento sets the order status to processing, and the order is ready to be invoiced.
 
-9. The PayPal gateway returns control of the customer's browser to the client.
+1. The PayPal gateway returns control of the customer's browser to the client.

_includes/graphql/payment-methods/payflow-link-workflow.md

@@ -1,8 +1,8 @@
-1. The PWA client uses the [`setPaymentMethodOnCart`]({{page.baseurl}}/graphql/reference/quote-payment-method.html) mutation to set the payment method.
+1. The PWA client uses the [`setPaymentMethodOnCart`]({{page.baseurl}}/graphql/mutations/set-payment-method.html) mutation to set the payment method.
 
 1. The mutation returns a `Cart` object.
 
-1. The client runs the [`placeOrder`]({{page.baseurl}}/graphql/reference/quote-place-order.html) mutation, which creates an order in Magento and begins the authorization process.
+1. The client runs the [`placeOrder`]({{page.baseurl}}/graphql/mutations/place-order.html) mutation, which creates an order in Magento and begins the authorization process.
 
 1. Magento requests a secure token from the Paypal gateway.
 

_includes/graphql/payment-methods/payflow-pro-workflow.md

@@ -1,27 +1,27 @@
-1. On the checkout page, the customer selects **Credit Card** as the payment method and enters the credit card information as well as the billing and shipping addresses. When the customer clicks **Place Order**, the PWA client uses the [`setPaymentMethodOnCart`]({{page.baseurl}}/graphql/reference/quote-payment-method.html) mutation to set the payment method to `payflowpro`.
+1. On the checkout page, the customer selects **Credit Card** as the payment method and enters the credit card information as well as the billing and shipping addresses. When the customer clicks **Place Order**, the PWA client uses the [`setPaymentMethodOnCart`]({{page.baseurl}}/graphql/mutations/set-payment-method.html) mutation to set the payment method to `payflowpro`.
 
-2. The mutation returns a `Cart` object.
+1. The mutation returns a `Cart` object.
 
-3. The client runs the [`createPayflowProToken`]({{page.baseurl}}/graphql/mutations/create-payflow-pro-token.html) mutation to initiate a transaction.
+1. The client runs the [`createPayflowProToken`]({{page.baseurl}}/graphql/mutations/create-payflow-pro-token.html) mutation to initiate a transaction.
 
-4. Magento requests a secure token from the PayPal gateway. The request also contains billing and shipping information, which Magento extracts from the `Cart` object.
+1. Magento requests a secure token from the PayPal gateway. The request also contains billing and shipping information, which Magento extracts from the `Cart` object.
 
-5. The gateway response includes a secure token, a secure token ID, and result codes and descriptions.
+1. The gateway response includes a secure token, a secure token ID, and result codes and descriptions.
 
-6. Magento returns the secure token, a secure token ID, and result codes and descriptions in response to the `createPayflowProToken` mutation.
+1. Magento returns the secure token, a secure token ID, and result codes and descriptions in response to the `createPayflowProToken` mutation.
 
-7. The client uses a hidden iframe to send a silent post request directly to the PayPal gateway for account verification. For live requests, send the silent post to `https://payflowlink.paypal.com`. Send test requests to `https://pilot-payflowlink.paypal.com`.
+1. The client uses a hidden iframe to send a silent post request directly to the PayPal gateway for account verification. For live requests, send the silent post to `https://payflowlink.paypal.com`. Send test requests to `https://pilot-payflowlink.paypal.com`.
 
-8. The gateway responds directly to the client. The response contains a payload that includes secure token information and billing and shipping information.
+1. The gateway responds directly to the client. The response contains a payload that includes secure token information and billing and shipping information.
 
-9. The client uses the [`handlePayflowProResponse`]({{page.baseurl}}/graphql/mutations/handle-payflow-pro-response.html) mutation to send the payload to Magento. Magento stores this information without modifying the cart.
+1. The client uses the [`handlePayflowProResponse`]({{page.baseurl}}/graphql/mutations/handle-payflow-pro-response.html) mutation to send the payload to Magento. Magento stores this information without modifying the cart.
 
-10. The mutation returns a `Cart` object.
+1. The mutation returns a `Cart` object.
 
-11. The client runs the [`placeOrder`]({{page.baseurl}}/graphql/reference/quote-place-order.html) mutation, which creates an order in Magento and begins the authorization process.
+1. The client runs the [`placeOrder`]({{page.baseurl}}/graphql/mutations/place-order.html) mutation, which creates an order in Magento and begins the authorization process.
 
-12. Magento sends an authorization request to the gateway.
+1. Magento sends an authorization request to the gateway.
 
-13. The gateway sends the response to Magento.
+1. The gateway sends the response to Magento.
 
-14. Magento creates an order and sends an order ID in response to the `placeOrder` mutation.
+1. Magento creates an order and sends an order ID in response to the `placeOrder` mutation.

_includes/graphql/payment-methods/paypal-express-checkout-workflow.md

@@ -10,14 +10,14 @@
 
 1. If the customer approves the payment, PayPal redirects the customer back to the payment confirmation page. The response includes the secure token and payer ID as GET parameters.
 
-1. Set the payment method. The frontend runs the [`setPaymentMethodOnCart`]({{page.baseurl}}/graphql/reference/quote-payment-method.html) mutation. The payload includes the PayPal token, the payer ID, and the cart ID. The cart may have been updated since the token was requested, as shipping costs, taxes, and other adjustments might have been applied to the cart. Magento submits the updated cart to PayPal.
+1. Set the payment method. The frontend runs the [`setPaymentMethodOnCart`]({{page.baseurl}}/graphql/mutations/set-payment-method.html) mutation. The payload includes the PayPal token, the payer ID, and the cart ID. The cart may have been updated since the token was requested, as shipping costs, taxes, and other adjustments might have been applied to the cart. Magento submits the updated cart to PayPal.
 
 1. Magento returns a `Cart` object.
 
-1. Place the order with the [`placeOrder`]({{page.baseurl}}/graphql/reference/quote-place-order.html) mutation.
+1. Place the order with the [`placeOrder`]({{page.baseurl}}/graphql/mutations/place-order.html) mutation.
 
 1. Magento sends the secure token, payer ID, and final cart information to PayPal.
 
 1. PayPal captures the payment by transferring the funds from the customer account to the appropriate merchant account.
 
-1. Magento creates an order, ready for fulfillment.
+1. Magento creates an order, ready for fulfillment.

guides/v2.3/graphql/mutations/add-configurable-products.md

@@ -11,7 +11,7 @@ Use the `addConfigurableProductsToCart` mutation to add configurable products to
 
 ## Example usage
 
-The following example adds two black Teton Pullover Hoodies size extra-small to the specified shopping cart. The `cart_id` used in this example was [generated]({{ page.baseurl }}/graphql/reference/quote-create-cart.html) by creating an empty cart.
+The following example adds two black Teton Pullover Hoodies size extra-small to the specified shopping cart. The `cart_id` used in this example was [generated]({{ page.baseurl }}/graphql/mutations/create-empty-cart.html) by creating an empty cart.
 
 **Request**
 
@@ -124,7 +124,7 @@ Attribute |  Data Type | Description
 
 {% include graphql/cart-object.md %}
 
-[Cart query output]({{page.baseurl}}/graphql/reference/quote.html#cart-output) provides more information about the `Cart` object.
+[Cart query output]({{page.baseurl}}/graphql/queries/cart.html#cart-output) provides more information about the `Cart` object.
 
 ## Related topics