GraphQL: Migrate products topics (#5265)

* checkpoint

* checkpoint 2

* fix navigation

* Mostly adding intro sentences before attribute tables

* review comments

* more review comments

* fix build problems

Author: keharper

_data/toc/graphql.yml

@@ -47,6 +47,8 @@ pages:
 
     - label: Queries
       children:
+        - label: category query
+          url: /graphql/queries/category.html
 
         - label: checkoutAgreements query
           url: /graphql/queries/checkout-agreements.html
@@ -72,6 +74,9 @@ pages:
         - label: customerOrders query
           url: /graphql/queries/customer-orders.html
 
+        - label: customerDownloadableProducts query
+          url: /graphql/queries/customer-downloadable-products.html
+
         - label: customerPaymentTokens query
           url: /graphql/queries/customer-payment-tokens.html
 
@@ -81,6 +86,9 @@ pages:
         - label: getPayflowLinkToken query
           url: /graphql/queries/get-payflow-link-token.html
 
+        - label: products query
+          url: /graphql/queries/products.html
+
         - label: storeConfig query
           url: /graphql/queries/store-config.html
 
@@ -92,6 +100,9 @@ pages:
 
     - label: Mutations
       children:
+        - label: addConfigurableProductsToCart mutation
+          url: /graphql/mutations/add-configurable-products.html
+
         - label: applyStoreCreditToCart mutation
           url: /graphql/mutations/apply-store-credit.html
 
@@ -113,37 +124,33 @@ pages:
         - label: removeStoreCreditFromCart mutation
           url: /graphql/mutations/remove-store-credit.html
 
-    - label: Reference
+    - label: Product data types and interfaces
       children:
-            - label: Customer endpoint
-              url: /graphql/reference/customer.html
+        - label: Product interface implementations
+          url: /graphql/product/product-interface-implementations.html
 
-            - label: Products endpoint
-              url: /graphql/reference/products.html
-              children:
-                - label: Product interface implementations
-                  url: /graphql/reference/product-interface-implementations.html
-
-                - label: CustomizableOptionInterface
-                  url: /graphql/reference/customizable-option-interface.html
+        - label: CustomizableOptionInterface
+          url: /graphql/product/customizable-option-interface.html
 
-                - label: BundleProduct endpoint
-                  url: /graphql/reference/bundle-product.html
+        - label: Bundle product data types
+          url: /graphql/product/bundle-product.html
 
-                - label: Category endpoint
-                  url: /graphql/reference/categories.html
+        - label: Configurable product data types
+          url: /graphql/product/configurable-product.html
 
-                - label: ConfigurableProduct endpoint
-                  url: /graphql/reference/configurable-product.html
+        - label: Downloadable product data types
+          url: /graphql/product/downloadable-product.html
 
-                - label: DownloadableProduct endpoint
-                  url: /graphql/reference/downloadable-product.html
+        - label: GiftCardProduct data types
+          url: /graphql/product/gift-card-product.html
 
-                - label: GiftCardProduct endpoint
-                  url: /graphql/reference/gift-card-product.html
+        - label: GroupedProduct data types
+          url: /graphql/product/grouped-product.html
 
-                - label: GroupedProduct endpoint
-                  url: /graphql/reference/grouped-product.html
+    - label: Reference
+      children:
+            - label: Customer endpoint
+              url: /graphql/reference/customer.html
 
             - label: Quote endpoint (cart query)
               url: /graphql/reference/quote.html

_data/whats-new.yml

@@ -474,7 +474,7 @@ entries:
   date: June 22, 2019
   link: https://github.com/magento/devdocs/pull/4402
 - description: Added the `only_x_left_in_stock` and `stock_status` attributes to the
-    [Products endpoint](https://devdocs.magento.com/guides/v2.3/graphql/reference/products.html).
+    [Products endpoint](https://devdocs.magento.com/guides/v2.3/graphql/queries/products.html).
     These attributes were added to support Inventory Management orders.
   versions: 2.3.2
   type: Technical changes
@@ -1032,8 +1032,8 @@ entries:
   type: Technical changes
   date: March 26, 2019
   link: https://github.com/magento/devdocs/pull/3882
-- description: Added query and mutation to the [configurable]( https://devdocs.magento.com/guides/v2.3/graphql/reference/configurable-product.html)
-    and [downloadable product](https://devdocs.magento.com/guides/v2.3/graphql/reference/downloadable-product.html)
+- description: Added query and mutation to the [configurable]( https://devdocs.magento.com/guides/v2.3/graphql/product/configurable-product.html)
+    and [downloadable product](https://devdocs.magento.com/guides/v2.3/graphql/product/downloadable-product.html)
     endpoints
   versions: 2.3.1
   type: Major update
@@ -1045,7 +1045,7 @@ entries:
   type: Major update
   date: March 26, 2019
   link: https://github.com/magento/devdocs/pull/3840
-- description: Added `url_path`, `url_key`, and `url_rewrites` to [product endpoint](https://devdocs.magento.com/guides/v2.3/graphql/reference/products.html)
+- description: Added `url_path`, `url_key`, and `url_rewrites` to [product endpoint](https://devdocs.magento.com/guides/v2.3/graphql/queries/products.html)
     and added URL rewrite attributes and examples to [UrlRewrite endpoint](https://devdocs.magento.com/guides/v2.3/graphql/reference/url-resolver.html)
   versions: 2.3.1
   type: Major update
@@ -1061,7 +1061,7 @@ entries:
   type: New topic
   date: March 26, 2019
   link: https://github.com/magento/devdocs/pull/3855
-- description: Added an example to [CustomizableOptionInterface](https://devdocs.magento.com/guides/v2.3/graphql/reference/customizable-option-interface.html)
+- description: Added an example to [CustomizableOptionInterface](https://devdocs.magento.com/guides/v2.3/graphql/product/customizable-option-interface.html)
   versions: 2.3.1
   type: Major update
   date: March 26, 2019
@@ -1619,7 +1619,7 @@ entries:
   versions: 2.3.x
   type: Major update
   date: November 20 2018
-- description: Added `CatalogInventory` attributes to the [products query](https://devdocs.magento.com/guides/v2.3/graphql/reference/products.html).
+- description: Added `CatalogInventory` attributes to the [products query](https://devdocs.magento.com/guides/v2.3/graphql/queries/products.html).
   versions: 2.3.x
   type: Technical changes
   date: November 16 2018
@@ -1885,7 +1885,7 @@ entries:
   versions: 2.3.x
   type: Technical changes
   date: Sep 5 2018
-- description: Added a note about filtered product attributes in [Products endpoint](https://devdocs.magento.com/guides/v2.3/graphql/reference/products.html)
+- description: Added a note about filtered product attributes in [Products endpoint](https://devdocs.magento.com/guides/v2.3/graphql/queries/products.html)
   versions: 2.3.x
   type: Technical changes
   date: Sep 5 2018
@@ -1957,7 +1957,7 @@ entries:
   versions: 2.3.x
   type: Major update
   date: Aug 21 2018
-- description: Added information about breadcrumbs in the [GraphQL category](https://devdocs.magento.com/guides/v2.3/graphql/reference/categories.html)
+- description: Added information about breadcrumbs in the [GraphQL category](https://devdocs.magento.com/guides/v2.3/graphql/queries/category.html)
     topic.
   versions: 2.3.x
   type: Major update
@@ -2218,7 +2218,7 @@ entries:
   versions: 2.1.x, 2.2.x, 2.3.x
   type: Technical changes
   date: May 29 2018
-- description: Updated the GraphQL [Products endpoint](https://devdocs.magento.com/guides/v2.3/graphql/reference/products.html)
+- description: Updated the GraphQL [Products endpoint](https://devdocs.magento.com/guides/v2.3/graphql/queries/products.html)
     to include functionality contributed by community members.
   versions: 2.3.x
   type: Technical changes
@@ -2251,7 +2251,7 @@ entries:
   versions: 2.1.x, 2.2.x, 2.3.x
   type: Technical changes
   date: May 15 2018
-- description: Added filter attribute information in [GraphQL Product](https://devdocs.magento.com/guides/v2.3/graphql/reference/products.html)
+- description: Added filter attribute information in [GraphQL Product](https://devdocs.magento.com/guides/v2.3/graphql/queries/products.html)
   versions: 2.3.x
   type: Technical changes
   date: May 10 2018

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

@@ -0,0 +1,131 @@
+---
+group: graphql
+title: addConfigurableProductsToCart mutation
+---
+
+Use the `addConfigurableProductsToCart` mutation to add configurable products to a specific cart.
+
+## Syntax
+
+`mutation: {addConfigurableProductsToCart(input: AddConfigurableProductsToCartInput) {AddConfigurableProductsToCartOutput}}`
+
+## 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.
+
+**Request**
+
+```graphql
+mutation {
+  addConfigurableProductsToCart(
+    input: {
+      cart_id: "4JQaNVJokOpFxrykGVvYrjhiNv9qt31C"
+      cart_items: [
+        {
+          variant_sku: "MH02"
+          data: {
+            quantity: 2
+            sku: "MH02-XS-Black"
+          }
+        }
+      ]
+    }
+  ) {
+    cart {
+      items {
+        id
+        quantity
+        product {
+          name
+          sku
+        }
+        ... on ConfigurableCartItem {
+          configurable_options {
+            option_label
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+**Response**
+
+```json
+{
+  "data": {
+    "addConfigurableProductsToCart": {
+      "cart": {
+        "items": [
+          {
+            "id": "26",
+            "quantity": 2,
+            "product": {
+              "name": "Teton Pullover Hoodie-XS-Black",
+              "sku": "MH02-XS-Black"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
+```
+
+## Input attributes
+
+### AddConfigurableProductsToCartInput object
+
+The `AddConfigurableProductsToCartInput` object contains the following attributes:
+
+Attribute | Type | Description
+--- | --- | ---
+`cart_items` | [[ConfigurableProductCartItemInput]](#configProdCartItemInput) | An array of configurable items to add to the cart
+`cart_id` | String | The unique ID that identifies the customer's cart
+
+### ConfigurableProductCartItemInput object {#configProdCartItemInput}
+
+The `ConfigurableProductCartItemInput` object contains the following attributes:
+
+Attribute | Type | Description
+--- | --- | ---
+`customizable_options` | [CustomizableOptionInput](#customOptionInput) | An object that contains the ID and value of the product
+`data` | [CartItemInput](#cartItemInput) | An object that contains the quantity and SKU of the configurable product
+`variant_sku` | String | The SKU of the simple product
+
+### CustomizableOptionInput object {#customOptionInput}
+
+The `CustomizableOptionInput` object contains the following attributes:
+
+Attribute | Type | Description
+--- | --- | ---
+`id` | Int | The ID of the customizable option
+`value` | String | The value of the customizable option. For example, if color was the customizable option, a possible value could be `black`
+
+### CartItemInput object {#cartItemInput}
+
+The `CartItemInput` object contains the following attributes:
+
+Attribute | Type | Description
+--- | --- | ---
+`quantity` | Float | The number of configurable items to add to the cart
+`sku` | String | The SKU of the configurable product
+
+## Output attributes
+
+The `AddConfigurableProductsToCartOutput` object contains the `Cart` object.
+
+Attribute |  Data Type | Description
+--- | --- | ---
+`cart` |[Cart!](#CartObject) | Describes the contents of the specified shopping cart
+
+### Cart object {#CartObject}
+
+{% include graphql/cart-object.md %}
+
+[Cart query output]({{page.baseurl}}/graphql/reference/quote.html#cart-output) provides more information about the `Cart` object.
+
+## Related topics
+
+-  [Configurable product data types]({{page.baseurl}}/graphql/product/configurable-product.html)