AdobeDocs / commerce-services

Source of the Commerce Services developer guide
https://developer.adobe.com/commerce/services/
Other
2 stars 10 forks source link

Confusing Eventing Documentation #126

Open cscrewvala opened 1 month ago

cscrewvala commented 1 month ago

Is there an existing issue for this?

What's missing?

  1. https://developer.adobe.com/commerce/services/shared-services/storefront-events/collector/#event-names-by-framework There is no explanation of what Framework means here i.e. add a paragraph to explain "The below table lists all possible types of events used in Commerce that can be published to the Adobe Datalayer in the browser. Some of these events are used to send to Sensei / Commerce Services for Product Recommendations and Live Search, whilst others can be used to send to Adobe Experience Platform Edge for use in other Adobe Experience Cloud Solutions (such as Real-Time CDP, Journey Optimizer, Analytics, Target etc)."

  2. https://developer.adobe.com/commerce/services/shared-services/storefront-events/collector/#event-support-by-framework In this section, 'framework' is used to mean something different - the front end technology - which is confusing. There is also no explanation what the Event Support By Framework means more specifically. e.g. I believe ALL Eventing needs to be manually implemented for PWA front end, so what does 'support' mean in this respect? No eventing is included OOTB for PWA, but any eventing is possible with development and using the SDK etc. So what does Support mean? A paragraph to explain what this means would be useful.

  3. All references to 'Snowplow' are confusing, as the use of Snowplow framework for event data object validation by Commerce Services is only explained on an obscure page in github. Remove them.