resolving feedback

Author: erikmarr

src/recommendations/events.md

@@ -12,7 +12,7 @@ If shoppers use ad blockers or enable privacy settings that prevent the `magento
 If [Cookie Restriction Mode](https://docs.magento.com/m2/ce/user_guide/stores/compliance-cookie-restriction-mode.html) is enabled, Magento does not collect behavioral data until the shopper consents. If Cookie Restriction Mode is disabled, Magento collects behavioral data by default.
 
 Event | Category | Description
---- | ---
+--- | --- | ---
 `add-to-cart` | product | A product is added to the cart
 `add-to-wishlist` | product | A product is added to the wishlist
 `apply-discount-action` | shopping-cart | A discount code is applied to the cart

src/recommendations/headless.md

@@ -6,32 +6,41 @@ ee_only: True
 
 You can integrate Product Recommendations in a headless storefront using either [PWA Studio](https://magento.github.io/pwa-studio/) or a custom frontend technology, such as React or Vue JS.
 
-Product Recommendations require [behavioral and catalog data ](https://devdocs.magento.com/recommendations/product-recs.html#types-of-data)to operate. The catalog data sync process remains unchanged in a headless implementation, but changes are needed for behavioral data collection. 
+Product Recommendations require [behavioral and catalog data]({{ page.baseurl }}recommendations/product-recs.html#types-of-data) to operate. The catalog data sync process remains unchanged in a headless implementation, but changes are needed for behavioral data collection.
 
-The roles of the custom storefront using Product Recommendations are two-fold: 
-1. send behavioral data to Adobe Sensei so that these events can be analyzed to compute Product Recommendation results; additional data can be sent to enable product recommendation [metrics reporting](https://docs.magento.com/user-guide/marketing/recommendation-metrics.html) 
-2. fetch product recommendation results and render them on the page 
+To integrate Product Recommendations in a headless storefront you must:
 
-Both of these actions can be performed using available SDKs as described below. 
+1. Send behavioral data to Adobe Sensei to analyze and compute Product Recommendation results. You also can send additional data to enable product recommendation [metrics reporting](https://docs.magento.com/user-guide/marketing/recommendation-metrics.html).
 
-Use the following workflow to integrate your headless storefront with Product Recommendations.
+1. Fetch product recommendation results and render those results on the page.
+
+You can perform both of these actions using the available SDKs as described below.
+
+The following workflow describes how to integrate Product Recommendation in a headless storefront.
 
 1. [Install the Product Recommendations]({{ page.baseurl }}/recommendations/install-configure.html) module.
 
-1. Install and use the [Storefront Events SDK]({{ page.baseurl }}/shared-services/storefront-events-sdk.html) to fire the [behavioral events](https://devdocs.magento.com/recommendations/events.html).
-The minimum required events to enable product recommendations are product view, add-to-cart, and place-order. 
-To enable metrics reporting (link), the following additional events are required: 
-recommendation-unit impression-render
-recommendation-unit view
-recommendation-unit rec-click
-recommendation-unit rec-add-to-cart-click (if an add-to-cart button is present in the Recs template) 
---
+1. Install and use the [Storefront Events SDK]({{ page.baseurl }}/shared-services/storefront-events-sdk.html) to fire the [behavioral events]({{ page.baseurl }}/recommendations/events.html).
+
+    The minimum required events to enable Product Recommendations are:
+
+    Event | Category
+    --- | ---
+    `view` | product
+    `add-to-cart` | product
+    `place-order` | checkout
 
+    To enable [metrics reporting](https://docs.magento.com/user-guide/marketing/recommendation-metrics.html), the following additional events are required:
 
-<br class="Apple-interchange-newline">
+    Event | Category
+    --- | ---
+    `impression-render` | recommendation-unit
+    `view` | recommendation-unit
+    `rec-click` | recommendation-unit
+    `rec-add-to-cart-click` | recommendation-unit (if an add to cart button is present in the recommendations template)
 
-1. When the events are fired, use the [Storefront Events Collector]({{ page.baseurl }}/shared-services/storefront-event-collector.html) as a handler to send them to Adobe Sensei.
+1. When the events are fired, use the [Storefront Events Collector]({{ page.baseurl }}/shared-services/storefront-event-collector.html) to handle the events and send them to Adobe Sensei.
 
-1. Once behavioral data collection is orchestrated using above steps, the business user can [create Product Recommendations](https://docs.magento.com/user-guide/marketing/create-new-rec.html) in the Commerce Admin.
+1. After the behavioral data is collected, you can [create Product Recommendations](https://docs.magento.com/user-guide/marketing/create-new-rec.html) in the Admin.
 
-1. Use the [Recommendations SDK]({{ page.baseurl }}/recommendations/recs-api.html) to fetch the recommendation units on the storefront. It returns necessary product data to render recommendation units on a page.
+1. Use the [Recommendations SDK]({{ page.baseurl }}/recommendations/recs-api.html) to fetch the recommendation units on the storefront. The SDK returns necessary product data to render recommendation units on a page.