Umbraco Commerce store setup docs

[acoumb]

Description

Documentation on setting up a store in Umbraco Commerce and common use cases documented using this demo store.

This is a draft version awaiting review from @mattbrailsford .

Type of suggestion

• Typo/grammar fix
• Updated outdated content
• New content
• Updates related to a new version
• Other

Product & version (if relevant)

Deadline (if relevant)

Pending review

[mattbrailsford]

@eshanrnh It's proving hard to review this directly from the markdown, I'd really like to see it in the actual docs site. Is that something we can do? or, if not, can we just merge it and I have a task on my todo list to review the docs structure etc anyway so could just come and cleanup anything I think needs cleaning up.

[sofietoft]

Hi @mattbrailsford and @acoumb !

You can preview the changes using the link the box just below the comments here.

However, all new articles will need to be added to the SUMMARY.md file first, otherwise they will not show up in the published docs or on GitBook.

Hope it makes sense!
We really don't want to merge something that hasn't been reviewed, so this will be a last resort.

[mattbrailsford]

Hmm, I'm not seeing that option

[mattbrailsford]

Ahh, never mind, looks like you can also just click the GitBook heading

[mattbrailsford]

@acoumb can you make sure the SUMMARY.md file is updated with links to these new sections such that they show up in the preview 👍

[acoumb]

@acoumb can you make sure the SUMMARY.md file is updated with links to these new sections such that they show up in the preview 👍

@mattbrailsford summary updated

[mattbrailsford]

@acoumb something isn't right here as all your other changes have gone. Also, if you have steps broken down into sub pages, these also need adding to the SUMMARY page.

[acoumb]

Indeed, I've reverted them some weeks ago when I added some UI Builder release notes. Taking care of this now.

[acoumb]

@mattbrailsford it should be alright now. Summary points to the setup store overview where all links are listed.

[mattbrailsford]

Something still isn't right as the links on the first overview page aren't working https://docs.umbraco.com/umbraco-commerce/~/revisions/DqkqRGXUWsFxB3DlbBoY/tutorials/overview-1

I believe that only pages listed in the SUMMARY.md file get deployed so you would need to list the pages as sub pages to the Store Setup entry, otherwise they won't get deployed.

[acoumb]

@mattbrailsford summary updated

[sofietoft]

Thanks @mattbrailsford (and happy birthday 🥳 )

[sofietoft]

Guides and tutorial looks great.

It would be great if you could add file names to the code snippets.
There are quite a few snippets throughout the guides and the steps in the tutorial, and it is not always clear which file the code should go into.
So, for consistency I suggest that file names are added to each code snippet.

It can be done by wrapping the code snippets like this:

{% code title="filenamehere.cs" %}

```csharp
//this is a code snippet.
```

{% endcode %}

I can do some, probably most, but there are some instances were I wouldn't know which file name to add.

[mattbrailsford]

@sofietoft that should be everything addressed 👍

[sofietoft]

Looks great @mattbrailsford ! 👏

I'll get this merged.

[sofietoft]

Let me know when we're ready @mattbrailsford !

I'll add the redirects after this is merged.

[mattbrailsford]

@sofietoft Should be good to go now. I just spotted a few class attributes on some of the code snippets which I removed everywhere else to keep the snippets focused on the main code. But that should be everything now so all good to merge.