Added descriptions and fixed vale errors

Author: eshanrnh

13/umbraco-engage/developers/ab-testing/csharp-api.md

@@ -4,7 +4,7 @@ description: >-
   Umbraco Engage C# API.
 ---
 
-# Retrieving A/B test variants in C\#
+# Retrieving A/B test variants in C#
 
 ## Retrieving Active A/B test variants
 

13/umbraco-engage/developers/personalization/custom-scoring.md

@@ -20,9 +20,11 @@ To implement our example above, we will be using the `ICustomerJourneyService`.
 To resolve the required services, we will use Dependency Injection:
 
 {% code overflow="wrap" %}
+
 ```csharp
 ICustomerJourneyGroupRepository _customerJourneyGroupRepository;ICustomerJourneyService _customerJourneyService;public MyController(ICustomerJourneyGroupRepository customerJourneyGroupRepository, ICustomerJourneyService customerJourneyService){    _customerJourneyGroupRepository = customerJourneyGroupRepository;    _customerJourneyService = customerJourneyService;}
 ```
+
 {% endcode %}
 
 We will now request Umbraco Engage to provide the customer journey step "**Do**" from the group "**Customer Journey**".
@@ -32,10 +34,12 @@ This is the default name for the customer journey upon installation.
 {% endhint %}
 
 {% code overflow="wrap" %}
+
 ```csharp
 var customerJourneyGroup = _customerJourneyGroupRepository.GetAll().FirstOrDefault(group => group.Title == "Customer Journey");
 var stepDo = customerJourneyGroup.Steps.FirstOrDefault(step => step.Title == "Do");
 ```
+
 {% endcode %}
 
 We can now inspect the step **Do** variable and find its `ID`. To score the step, we provide the `ID` and the score to the `CustomerJourneyService`:

13/umbraco-engage/marketers-and-editors/ab-testing/what-is-ab-testing.md

@@ -1,3 +1,8 @@
+---
+description: >-
+  Learn how A/B testing helps optimize your website by comparing different versions to improve performance, integrated seamlessly with Umbraco Engage.
+---
+
 # What is A/B testing
 
 It goes too far to give a total overview of what A/B testing is. There are some great resource out there that can inspire you and can go in real depth what A/B testing is.

13/umbraco-engage/marketers-and-editors/analytics/campaigns.md

@@ -29,7 +29,7 @@ If you want to use these parameters, you will need to set up the URL like:
 
 {% code overflow="wrap" %}
 
-```
+```cs
 https://www.umbraco.com/pricing/?utm_source=newsletter-july-2024&utm_medium=newsletter&utm_campaign=more_signups&utm_content=bottom_button
 ```
 

13/umbraco-engage/marketers-and-editors/personalization/implicit-and-explicit-personalization/campaign-scoring.md

@@ -12,7 +12,7 @@ description: >-
 Campaigns are automatically scored by using utm-parameters, that you may be already using for your marketing campaigns. You can add 5 different parameters to your URL:
 
 * **utm_source**: Identify the advertiser, site, publication, etc. that is sending traffic to your property, for example, Google, newsletter4, billboard.
-* **utm_medium**: The advertising or marketing medium, for example, CPC, banner, email newsletter.
+* **utm_medium**: The advertising or marketing medium, for example, Cost Per Click (CPC), banner, email newsletter.
 * **utm_campaign**: The individual campaign name, slogan, and promo code for a product.
 * **utm_term**: Identify paid search keywords. If you are manually tagging paid keyword campaigns, you should also use utm_term to specify the keyword.
 * **utm_content**: Used to differentiate similar content, or links within the same ad. For example, if you have two call-to-action links within the same email message, you can use utm_content and set different values for each so you can tell which version is more effective.
@@ -30,7 +30,7 @@ If you want to use these parameters you'll need to set the URL as:
 
 {% code overflow="wrap" %}
 
-```
+```cs
 https://www.umarketingsuite.com/pricing/?utm_source=newsletter-july-2021&utm_medium=newsletter&utm_campaign=more_signups&utm_content=bottom_button
 ```
 
@@ -42,7 +42,7 @@ Now that you've created URLs for campaigns they will automatically be tracked by
 
 going to **Personalization** -> **Campaign scoring** you will see all the campaign groups, the campaigns you already scored, and the campaigns that need scoring.
 
-<figure><img src="../../../.gitbook/assets/engage-personalization-campaign-scoring.png" alt="Scoring your campaign."><figcaption><p>Scoring your campaign.</p></figcaption></figure>
+![Scoring your campaign](../../../.gitbook/assets/engage-personalization-campaign-scoring.png)
 
 ### Creating a campaign group
 
@@ -58,7 +58,7 @@ You can add a new campaign group by clicking "**Add new group**". This will open
 
 </div>
 
-In this case, we created a campaign group "**A campaign group for developers**" and assigned **7 points** to the **developer** persona. This means when visitors come to the website via a URL with utm-parameters part of this campaign group, get 7 points for the developer persona.
+In this case, we created a campaign group "**A campaign group for developers**" and assigned **7 points** to the **developer** persona. Visitors arriving via a URL with utm-parameters part of this campaign group, get 7 points for the developer persona.
 
 Because we haven't assigned any campaigns yet, in this case, the group will never be triggered.
 
@@ -70,7 +70,7 @@ An example of this tab could look like this:
 
 <figure><img src="../../../.gitbook/assets/image (8) (1) (1).png" alt="Unscored campaigns."><figcaption><p>Unscored campaigns.</p></figcaption></figure>
 
-So here you see that in the last row, for example, the **utm_source** is "**Activate account**", the **utm_medium** is "**email**" and the **utm_content** is "**click here to activate your account**". The URL that the visitor used to get to the website looked something like `https://<url>?utm_source=activate account&utm_medium=email&utm_content=click here to activate your account.`
+In the last row, for example, the **utm_source** is "**Activate account**", **utm_medium** is "**email**" and **utm_content** is **click here to activate your account**. The URL that the visitor used to get to the website looked something like `https://<url>?utm_source=activate account&utm_medium=email&utm_content=click here to activate your account.`
 
 Every unscored campaign can be assigned to a campaign group by clicking on the "**Assign**" button. If you do that a popup will open that allows you to assign the specific campaign to one of your created campaign groups.
 
@@ -80,7 +80,7 @@ Every unscored campaign can be assigned to a campaign group by clicking on the "
 
 </div>
 
-By assigning this example to the "**A campaign group for developers**" from now on every visitor that comes to the website with these `utm-parameters` set up will get the points assigned that are set up in the campaign group. In this example, this would be **7 points** for **developers**.
+Assigning this to "**A campaign group for developers**" ensures all visitors with these `utm-parameters` will get the points assigned in the campaign group. In this example, this would be **7 points** for **developers**.
 
 ### Scored campaigns
 

13/umbraco-engage/marketers-and-editors/settings/setting-up-goals.md

@@ -8,7 +8,7 @@ description: >-
 
 Goals are important in Umbraco Engage. Without goals you cannot determine whether your optimization strategy through [A/B Testing](../ab-testing/) or [Personalization](../personalization/) really works.
 
-A/B Testing and/or Personalization is never the goal; the goal is to increase your goals which can be achieved by personalization or A/B testing.
+A/B Testing and/or Personalization is never the goal. The goal is to increase your goals which can be achieved by personalization or A/B testing.
 
 In the Goals menu, you can set up goals and specify their value.
 
@@ -39,4 +39,3 @@ You can specify how the goal will be triggered:
 * Via some custom code
 
 <figure><img src="../../.gitbook/assets/engage-settings-setup-new-goal.png" alt=""><figcaption><p>Create a new goal by giving it a name, setting a value and deciding on a set of parameters.</p></figcaption></figure>
-

13/umbraco-engage/security-and-privacy/gdpr/README.md

@@ -1,3 +1,8 @@
+---
+description: >-
+  Read how Umbraco Engage is designed with GDPR compliance in mind, ensuring data privacy through first-party cookies, data anonymization, and retention controls
+---
+
 # GDPR & EU regulation
 
 **Disclaimer**: Always check you are GDPR compliant with your own privacy office or legal department
@@ -41,6 +46,6 @@ Remember to adjust the template to match the configuration on your website.
 
 [The Umbraco Engage cookie can be categorized as both an analytical and a personalization cookie.](../../developers/introduction/the-umbraco-engage-cookie/) The cookie is used to analyze website visitor behavior and personalize content based on this behavior. Based on the GDPR and ePrivacy Directive cookie consent is required for gathering analytic and personalization data.
 
-As a customer and the controller of the personal data processed, **it is your responsibility to obtain consent from the website visitor for the use of the Umbraco Engage cookie**. Consent can be obtained using a cookie banner.
+As the data controller **it is your responsibility to obtain consent from the website visitor for the use of the Umbraco Engage cookie**. Consent can be obtained using a cookie banner.
 
-You can [control the features ](../../developers/introduction/the-umbraco-engage-cookie/module-permissions.md)and give your visitors total control over which features they wish to enable.
+You can [control the features](../../developers/introduction/the-umbraco-engage-cookie/module-permissions.md)and give your visitors total control over which features they wish to enable.

13/umbraco-engage/security-and-privacy/how-it-works.md

@@ -1,3 +1,8 @@
+---
+description: >-
+  Explore how Umbraco Engage collects browsing behavior data upon cookie acceptance to enable analytics, A/B testing, content personalization, and user profiling, all stored locally
+---
+
 # How it works
 
 When visitors accept the Umbraco Engage cookie on the website, it allows Umbraco Engage to collect and store data about browsing behavior, preferences, and interactions. This data can include pages visited, time spent on each page, actions taken on the site, and more. This data cannot be shared with 3rd parties because the data is stored in the local database of the site.

13/umbraco-engage/support.md

@@ -1,6 +1,11 @@
+---
+description: >-
+  The article explains how to seek support through Umbraco's website to create a support request.
+---
+
 # Support
 
-### Looking for support?
+## Looking for support?
 
 Seeking support or guidance? Go to [umbraco.com](https://umbraco.com) and look for the friendly speech bubble icon in the bottom right corner of your screen. Click on it, and you can open a new support request.
 

13/umbraco-engage/tutorials/README.md

@@ -13,4 +13,3 @@ Use the tutorials in this section to learn how Umbraco Engage works and set up s
 ## [How to set up an A/B Test](set-up-your-first-ab-test.md)
 
 ## [Marketing Resources](marketing-resources/)
-