Umbraco Commerce - product variants docs need expansion/improvement

[tormnator]

What type of issue is it? (Choose one - delete the others)

Missing documentation

What article/section is this about?

https://docs.umbraco.com/umbraco-commerce/key-concepts/product-variants

Describe the issue

The product variants concept should be much better documented. Single-variant products are easier, but still needs better explanation and how-to guides/tutorials. Multi-variant products involve configuration in multiple places and most likely coding as well. There's an older block article from Vendr which has the best explanation that I have found: https://vendr.net/blog/vendr-1-5-0-release-candidate/.

Btw, what's the difference between "how-to guides" and "tutorials"? They are separate sections in the left-side menu.

[alina-tincas]

Hi @tormnator! 👋

Thank you for bringing this to our attention! I have discussed this with our team and we will update the documentation to ensure the "Multi-variants" are on the current documentation, and we will look in the future to add more documentation for the "single-variant".

As for the difference between "how-to guides" and "tutorials", how-to guides are generally very focused on one particular feature like "how to create a discount code", or "how to add an action to the order list". They are used mainly by those who have a specific need. Tutorials are much broader and cover multiple subjects to create an overall example. This is used more by those exploring how to use the product and how the product works.

[alina-tincas]

Hi @tormnator we have created a page for "complex-variants" here: https://docs.umbraco.com/umbraco-commerce/key-concepts/product-variants/complex-variants and added a new issue for missing documentation for "Child Variants" on #5416 👍

Thank you again for bringing this up 💪

[tormnator]

Great job! 👍