Merge branch 'main' into task/cicd-v2-docs

Author: jesp209i

.github/pull_request_template.md

@@ -1,19 +1,33 @@
-## Description
+## 📋 Description
 
-_What did you add/update/change?_
+<!-- A clear and concise description of what this PR changes or adds. Include context if necessary. -->
 
-## Type of suggestion
+## 📎 Related Issues (if applicable)
 
-* [ ] Typo/grammar fix
-* [ ] Updated outdated content
-* [ ] New content
-* [ ] Updates related to a new version
-* [ ] Other
+<!-- List any related issues, e.g. "Fixes #1234" -->
 
-## Product & version (if relevant)
+## ✅ Contributor Checklist
 
+I've followed the [Umbraco Documentation Style Guide](https://docs.umbraco.com/contributing/documentation/style-guide) and can confirm that:
 
+* [ ] Code blocks are correctly formatted.
+* [ ] Sentences are short and clear (preferably under 25 words).
+* [ ] Passive voice and first-person language (“we”, “I”) are avoided.
+* [ ] Relevant pages are linked.
+* [ ] All links work and point to the correct resources.
+* [ ] Screenshots or diagrams are included if useful.
+* [ ] Any code examples or instructions have been tested.
+* [ ] Typos, broken links, and broken images are fixed.
+
+## Product & Version (if relevant)
+
+<!-- Mention the product and all applicable versions for which the PR is being created. -->
 
 ## Deadline (if relevant)
 
-_When should the content be published?_
+<!-- When should the content be published? -->
+
+## 📚 Helpful Resources
+
+* 🧾 [Umbraco Contribution Guidelines](https://docs.umbraco.com/contributing)
+* ✍️ [Umbraco Documentation Style Guide](https://docs.umbraco.com/contributing/documentation/style-guide)

13/umbraco-cms/fundamentals/setup/install/README.md

@@ -12,7 +12,7 @@ The fastest way to get the latest version of Umbraco up and running is using the
 2. Install the Umbraco templates:
 
 ```bash
-dotnet new install Umbraco.Templates::13.*`
+dotnet new install Umbraco.Templates::13.*
 ```
 
 {% hint style="info" %}
@@ -22,7 +22,7 @@ Replace `13.*` with the specific version you want to install.
 Example:
 
 ```bash
-dotnet new install Umbraco.Templates::13.8.1`
+dotnet new install Umbraco.Templates::13.8.1
 ```
 
 {% endhint %}

13/umbraco-commerce/how-to-guides/add-item.md

@@ -4,7 +4,7 @@ description: How-To Guide to add an item to your cart.
 
 # Add item to Cart
 
-To add an item to the cart, configure Umbraco with a store and add the necessary properties for interaction. Learn more by following the [Getting started with Umbraco Commerce: The Backoffice tutorial](../tutorials/getting-started-with-commerce).
+To add an item to the cart, configure Umbraco with a store and add the necessary properties for interaction. Learn more by following the [Getting started with Umbraco Commerce](../getting-started/umbraco-configuration.md).
 
 You will need the front end to be set up to allow an item to be added to the cart. This can be done by adding a button to the front end to call the Action to add the item to the cart.
 
@@ -30,30 +30,30 @@ var price = product.TryCalculatePrice().ResultOrThrow("Unable to calculate produ
 
 The code above does the following:
 
-- You need to access the store to access the relevant properties for your product, such as price. The store has a fallback property allowing you to traverse the tree to find the store.
-- You retrieve the product based on the store and a reference for the product. The 'productReference' comes from the Model which is a single product. 
-- The Product is returned as a ProductSnapshot which is Umbraco Commerce obtaining the page ID and carrying out necessary processes to bring in the data for further processing.
-- Finally, you need to calculate the price which is then displayed without VAT. This can also be displayed with VAT.
+* You need to access the store to access the relevant properties for your product, such as price. The store has a fallback property allowing you to traverse the tree to find the store.
+* You retrieve the product based on the store and a reference for the product. The 'productReference' comes from the Model which is a single product.
+* The Product is returned as a ProductSnapshot which is Umbraco Commerce obtaining the page ID and carrying out necessary processes to bring in the data for further processing.
+* Finally, you need to calculate the price which is then displayed without VAT. This can also be displayed with VAT.
 
 To display this you need to add some markup or at least amend it to include a button to add an item. Add the following to the same file:
 
 ```csharp
 @using (Html.BeginUmbracoForm("AddToCart", "CartSurface"))
 {
-	@Html.Hidden("productReference", Model.Key.ToString())
-	<h1>@Model.Value<string>("productTitle")</h1>
-	<h2>@Model.Value<string>("productDescription")</h2>
+ @Html.Hidden("productReference", Model.Key.ToString())
+ <h1>@Model.Value<string>("productTitle")</h1>
+ <h2>@Model.Value<string>("productDescription")</h2>
 
-	<p>Our price excluding VAT <strong>@price.WithoutTax.ToString("C0") </strong></p>
+ <p>Our price excluding VAT <strong>@price.WithoutTax.ToString("C0") </strong></p>
 
-	if (@Model.Value<int>("stock") == 0)
-	{
-		<p>Sorry, out of stock</p>
-	}
-	else
-	{
-		<button type="submit">Add to Basket</button>
-	}
+ if (@Model.Value<int>("stock") == 0)
+ {
+  <p>Sorry, out of stock</p>
+ }
+ else
+ {
+  <button type="submit">Add to Basket</button>
+ }
 
 }
 ```
@@ -166,12 +166,12 @@ public IActionResult AddToBasket(CartDto cart)
 
 The code above does the following:
 
-- The `store` variable is used to access the store to get the store ID.
-- A try-catch block captures any errors that may occur when adding the item to the cart, including any validation errors.
-- `order` is used to retrieve the current order if one exists or create a new order against the store found. In the Commerce API, everything is read-only for performance so you need to make it writable to add the product.
-- `AddProduct` is called and `productReference` is passed along with the quantity.
-- `SaveOrder` is called to save the order.
-- `TempData` stores a message to be displayed to the user if the product has been added to the cart.
+* The `store` variable is used to access the store to get the store ID.
+* A try-catch block captures any errors that may occur when adding the item to the cart, including any validation errors.
+* `order` is used to retrieve the current order if one exists or create a new order against the store found. In the Commerce API, everything is read-only for performance so you need to make it writable to add the product.
+* `AddProduct` is called and `productReference` is passed along with the quantity.
+* `SaveOrder` is called to save the order.
+* `TempData` stores a message to be displayed to the user if the product has been added to the cart.
 
 {% hint style="warning" %}
 Umbraco Commerce uses the Unit of Work pattern to complete saving the item (`uow.Complete`). When retrieving or saving data ideally you would want the entire transaction to be committed. However, if there is an error nothing is changed on the database.
@@ -187,12 +187,12 @@ Create a new partial view called `Feedback.cshtml`.
 @Html.ValidationSummary(true, "", new { @class = "danger" })
 
 @{
-	var success = TempData["SuccessFeedback"]?.ToString();
+ var success = TempData["SuccessFeedback"]?.ToString();
 
-	if (!string.IsNullOrWhiteSpace(success))
-	{
-		<div class="success">@success</div>
-	}
+ if (!string.IsNullOrWhiteSpace(success))
+ {
+  <div class="success">@success</div>
+ }
 }
 ```
 

13/umbraco-commerce/how-to-guides/overview.md

@@ -8,5 +8,5 @@ In this section, we will provide a series of How-To Guides, showcasing how to pe
 
 ## Available guides
 
-<table data-card-size="large" data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center">Migrate from Vendr to Umbraco Commerce</td><td><a href="migrate-from-vendr-to-umbraco-commerce/">migrate-from-vendr-to-umbraco-commerce</a></td></tr><tr><td align="center">Configure SQLite support</td><td><a href="configure-sqlite-support.md">configure-sqlite-support.md</a></td></tr><tr><td align="center">Add item to Cart</td><td><a href="add-item.md">add-item.md</a></td></tr><tr><td align="center">Update Cart</td><td><a href="update-cart.md">update-cart.md</a></td></tr>
+<table data-card-size="large" data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center">Migrate from Vendr to Umbraco Commerce</td><td><a href="../upgrading/migrate-from-vendr-to-umbraco-commerce/README.md">migrate-from-vendr-to-umbraco-commerce</a></td></tr><tr><td align="center">Configure SQLite support</td><td><a href="configure-sqlite-support.md">configure-sqlite-support.md</a></td></tr><tr><td align="center">Add item to Cart</td><td><a href="add-item.md">add-item.md</a></td></tr><tr><td align="center">Update Cart</td><td><a href="update-cart.md">update-cart.md</a></td></tr>
 <tr><td align="center">Delete item from Cart</td><td><a href="delete-item.md">delete-item.md</a></td></tr><tr><td align="center">Limit Order Line Quantity</td><td><a href="limit-orderline-quantity.md">limit-orderline-quantity.md</a></td></tr><tr><td align="center">Use an alternative database for Umbraco Commerce tables</td><td><a href="use-an-alternative-database-for-umbraco-commerce-tables.md">use-an-alternative-database-for-umbraco-commerce-tables.md</a></td></tr></tbody></table>

13/umbraco-commerce/key-concepts/product-bundles.md

@@ -42,4 +42,4 @@ By adding sub-products to a bundle, Umbraco Commerce knows to automatically sum
 
 As you can imagine, product bundles could get rather large making it a little difficult to display them in the backoffice. Umbraco Commerce bundles order lines together in a collapsible user interface. This gives you a clear view of your orders whilst still being able to drill into the detail of the items purchased.
 
-![Product bundles in the backoffice](../media/backback-office-bundles.png)
+![Product bundles in the backoffice](../media/back-office-bundles.png)

13/umbraco-commerce/reference/stores/README.md

@@ -79,7 +79,7 @@ Further store configuration can be achieved by setting up different categories o
 
 The available configuration options are:
 
-* **Locations** - Defines different locations for a store. See [Locations reference documentation](broken-reference) for more details.
+* **Locations** - Defines different locations for a store.
 * **Order Statuses** - Defines the order statuses to be used by a store.
 * **Shipping Methods** - Defines the different shipping options available in the store. See [Shipping reference documentation](../shipping/) for more details.
 * **Payment Methods** - Defines the different payment options available in the store.

13/umbraco-commerce/release-notes/README.md

@@ -9,7 +9,7 @@ In this section, we have summarized the changes to Umbraco Commerce that were re
 If there are any breaking changes or other issues to be aware of when upgrading they are also noted here.
 
 {% hint style="info" %}
-If you are upgrading to a new major version, check the breaking changes in the [Version Specific Upgrade Notes](upgrading/version-specific-upgrades.md) article.
+If you are upgrading to a new major version, check the breaking changes in the [Version Specific Upgrade Notes](../upgrading/version-specific-upgrades.md) article.
 {% endhint %}
 
 ## Release History

13/umbraco-commerce/upgrading/version-specific-upgrades.md

@@ -8,7 +8,7 @@ description: >-
 This page covers specific upgrade documentation for when migrating to major 13 of Umbraco Commerce.
 
 {% hint style="info" %}
-If you are upgrading to a new minor or patch version, you can find information about the breaking changes in the [Release Notes](../release-notes.md) article.
+If you are upgrading to a new minor or patch version, you can find information about the breaking changes in the [Release Notes](../release-notes/README.md) article.
 {% endhint %}
 
 ## Version Specific Upgrade Notes History

13/umbraco-deploy/deployment-workflow/restoring-content/README.md

@@ -30,7 +30,7 @@ This will restore **all** content and media, plus any other entities configured
 3. When it's complete select _Open Umbraco_ to go to the backoffice.
 4. You will now see all your content and media in the Umbraco backoffice.
 
-![Restore from start-up](../../../umbraco-cloud/deployment/restoring-content/images/Normal-Restore.gif)
+![Restore from start-up](images/Normal-Restore.gif)
 
 ### Restore everything through the Umbraco backoffice
 

13/umbraco-deploy/deployment-workflow/restoring-content/partial-restore.md

@@ -57,4 +57,4 @@ Imagine that you are working with your Umbraco project locally. One of your cont
 6. Start the restore by clicking _Restore_
 7. When the restore is done, reload the content tree to see the changes
 
-![Partial restore](../../../umbraco-cloud/deployment/restoring-content/images/partialRestore-onEnvWithContent.png)
+![Partial restore](images/partialRestore-onEnvWithContent.png)