Documentation example keep using an extension method that isn't included in Umbraco Commerce

[jemayn]

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

Wrong documentation

What article/section is this about?

Multiple, originally found on https://docs.umbraco.com/umbraco-commerce/tutorials/build-a-store/cart/custom-cart

Describe the issue

I've been looking at this article: https://docs.umbraco.com/umbraco-commerce/tutorials/build-a-store/cart/custom-cart

And in some of the examples it has this code for finding the current store:

StoreReadOnly store = CurrentPage!.GetStore()!;

However, when trying to adapt the example I could not find the GetStore() extension method anywhere.
When searching the documentation I found many references to it in examples, but no explanation of what it does / which NuGet package it comes from:

After some more digging I found that it is an extension method that is set up in the demo store here:
https://github.com/umbraco/Umbraco.Commerce.DemoStore/blob/96059c2fe95312604de9ff1dff139e30e4694dec/src/Umbraco.Commerce.DemoStore/Extensions/PublishedContentExtensions-Cart.cs#L12

I don't think the examples in the documentation should contain code that is not readily available when installing - or atleast all the examples using the method should have a note on where to find the source of it 🙂

[mattbrailsford]

GetStore is documented in the useful extensions section at that end of that tutorial https://docs.umbraco.com/umbraco-commerce/tutorials/build-a-store/cart/custom-cart#useful-extension-methods

[jemayn]

That's a good point, I hadn't made it that far. I guess it's good that it is documented, but maybe the extensions should be moved up to before all the examples that depend on them 🙂

I'd assume most people like me would follow the examples from the top and get confused.

[mattbrailsford]

It's always a hard balance to make as we don't want to bombard you with boilerplate stuff prior to the real meat of the tutorial, but I can appreciate if you are trying to follow along real-time you aren't going to see the extensions till the end.