GITBOOK-41: Fixed formatting

Author: eshanrnh

13/umbraco-ums/developers/headless/headless-example.md

@@ -1,6 +1,7 @@
 ---
 description: >-
-  This article shows how to personalize content using the uMarketingSuite Headless API and Umbraco’s Content Delivery API.
+  This article shows how to personalize content using the uMarketingSuite
+  Headless API and Umbraco’s Content Delivery API.
 ---
 
 # Headless Example
@@ -12,12 +13,12 @@ This article shows how to use the uMarketingSuite Headless API with Umbraco Cont
 1. Go to the **Marketing** > **Personalization** section.
 2. Navigate to the **Segments** tab.
 3. Click **Add new Segment**.
-  * Give the segment a name. For example: **Morning People**.
-  * And a description such as **For people who like to visit us in the morning**.
-  * Set the segment type to **Core** as we don't wish this to be temporary and tied to end date for a campaign.
-  * Select the **Time of day** parameter and configure it to **Include** times from **00:00** to **12:00** as it is a 24 hour clock.
+   * Give the segment a name. For example: _Morning People_.
+   * And a description such as _For people who like to visit us in the morning_.
+   * Set the segment type to **Core** as this is not temporary and is tied to an end date for a campaign.
+   * Select the **Time of day** parameter and configure it to **Include** times from **00:00** to **12:00** as it is a 24-hour clock.
 
-For more information, see the [Personalization](../personalization/README.md) documentation.
+For more information, see the [Personalization](../personalization/) documentation.
 
 ![]()
 
@@ -27,28 +28,24 @@ For more information, see the [Personalization](../personalization/README.md) do
 2. Click **Create a New Document Type**.
 3. Enable **Allow Segmentation** under **Permissions**.
 4. Save the Document Type.
-5. Add a new property, such as **Header**, using a **Textstring** property editor.
-
-  * Ensure **Allow Segmentation** is enabled for this property.
-
-6. Create a piece of content using this new Document Type so we can query and request it using the Umbraco Content Delivery API
-
-  * _For this example lets create this piece of content at the root_
+5. Add a new property, such as a **Header**, using a **Textstring** property editor.
+   * Ensure **Allow Segmentation** is enabled for this property.
+6. Create a piece of content using this new Document Type to query and request it using the Umbraco Content Delivery API
+   * For this example, create this piece of content at the root.
 
 ### Creating Personalized Content
 
 1. Open the created content and go to **Personalization**.
 2. Click **Add personalized variant**.
 3. Set the following in the **Add a new variant** dialog:
-
-  * Choose the segment **Morning People** we added earlier.
-  * Give it a name and a meaningful description such as **Home Page for Morning People**.
+   * Choose the segment **Morning People** we added earlier.
+   * Give it a name and a meaningful description such as **Home Page for Morning People**.
 
 ![]()
 
-4. After adding the variant we will return to the content node in split view mode
-5. We can then add a different piece of content we want to return in our Header property specific to morning people such as **Hello you early risers**
-6. Save and publish the node with the variant content
+4. After adding the variant we will return to the content node in split view mode.
+5. We can then add a different piece of content we want to return in our Header property specific to morning people such as _Hello you early risers._
+6. Save and publish the node with the variant content.
 
 ![]()
 
@@ -59,19 +56,16 @@ Let us use the Swagger development tool to make requests to the Umbraco Content
 1. Navigate to the swagger endpoint of your site **/umbraco/swagger**.
 2. Select **Umbraco Delivery API** from the dropdown.
 3. Expand `/umbraco/delivery/api/v1/content/item/{path}`:
-
-  * Click **Try it out**.
-  * For the path parameter, enter `/` for the example piece of content we created at the root of our site - alternatively specify the correct URL path to the content
-  * Set the **Api-Key** parameter if your Umbraco application requires [Public Access](https://docs.umbraco.com/umbraco-cms/reference/content-delivery-api#additional-configuration) this can be toggled with the configuration value `Umbraco:CMS:DeliveryAPI:PublicAccess`
-
-4. You should see the JSON result of the content node, including the default header value.
+   * Click **Try it out**.
+   * For the path parameter, enter `/` for the example piece of content we created at the root of our site - alternatively specify the correct URL path to the content. 
+   * Set the **Api-Key** parameter if your Umbraco application requires [Public Access](https://docs.umbraco.com/umbraco-cms/reference/content-delivery-api#additional-configuration) this can be toggled with the configuration value `Umbraco:CMS:DeliveryAPI:PublicAccess`
+4. You should view the JSON result of the content node, including the default header value.
 5. Navigate to **uMarketingSuite Marketing API** from the definitions dropdown.
-* Expand `/umbraco/umarketingsuite/api/v1/analytics/pageview/trackpageview/client`:
-
-  * Click **Try it out**.
-  * Modify the JSON body, setting the URL to the page visited earlier. With the content delivery api above, leave the other property **referrerUrl** empty.
-* Repeat the earlier steps to fetch the content by it's path. The JSON of the content node and the header property now contains our personalized content **Hello you early risers**
-  * Remember it will only show different content if we view the page before midday.
+6. Expand `/umbraco/umarketingsuite/api/v1/analytics/pageview/trackpageview/client`:
+   * Click **Try it out**.
+   * Modify the JSON body, setting the URL to the page visited earlier. With the content delivery api above, leave the other property **referrerUrl** empty.
+   * Repeat the earlier steps to fetch the content by it's path. The JSON of the content node and the header property now contains our personalized content **Hello you early risers**
+     * Remember it will only show different content if we view the page before midday.
 
 ![]()
 

13/umbraco-ums/marketers-and-editors/personalization/creating-a-segment.md

@@ -25,9 +25,8 @@ To create a new segment, follow these steps:
 
 3. Give the new segment a **Name** and a short **Description**.
 4. Select a segment type:
-
-* **Core segments** are the fundamental building blocks of your personalization strategy
-* **Temporary segments** are segments **with an end date**. If some sort of campaign is running and you want to overrule existing segments you can create a temporary segment. For doing this you need to specify an end date
+   * **Core segments** are the fundamental building blocks of your personalization strategy
+   * **Temporary segments** are segments **with an end date**. If some sort of campaign is running and you want to overrule existing segments you can create a temporary segment. For doing this you need to specify an end date
 
 ### Segment Parameters
 
@@ -52,17 +51,17 @@ By clicking on the tile you will setup a parameter for the segment. For example,
 
 ![]()
 
-You see all browsers that have visited the website. So if you're missing a specific browser, that is because a visitor to your site has yet to use that browser.
+You will see all browsers that have visited the website. So if you're missing a specific browser, that is because a visitor to your site has yet to use that browser.
 
-You can save the parameter and the segment will show the parameter that is part of this segment.
+3. Save the parameter and the segment will show the parameter that is part of this segment.
 
 ![]()
 
-3. Add a parameter for **Time of day** to select all visitors after "**15:00**". Enter **15:00** in **From** and leave **Until** empty.
+4. Add a parameter for **Time of day** to select all visitors after "**15:00**". Enter **15:00** in **From** and leave **Until** empty.
 
 ![]()
 
-Now we can save this parameter and add the segment.
+5. Save this parameter and add the segment.
 
 We have now created a first segment and you will find that segment in the overview of your segments:
 

13/umbraco-ums/marketers-and-editors/profiling/profile-detail.md

@@ -1,10 +1,10 @@
 ---
 description: >-
-  Discover how to analyze visitor profiles, including insights on engagement metrics, 
-  potential, personas, and detailed activity tracking.
+  Discover how to analyze visitor profiles, including insights on engagement
+  metrics,  potential, personas, and detailed activity tracking.
 ---
 
-# Profile Detail
+# Profile detail
 
 In the Profiles section, you can access specific visitor profiles, which contain two sections: **Insights** and **Activity**.
 
@@ -16,12 +16,12 @@ The insights section provides an overview of the visitor.
 
 Here, you can see:
 
-- The date of the visitor's first session on the website,
-- The date of the visitor's last activity,
-- The number of sessions,
-- The number of pageviews,
-- The time spent on the website, and
-- The total engaged time.
+* The date of the visitor's first session on the website,
+* The date of the visitor's last activity,
+* The number of sessions,
+* The number of pageviews,
+* The time spent on the website, and
+* The total engaged time.
 
 You can also view any goals triggered by this visitor.
 
@@ -35,11 +35,11 @@ By default, a profile is considered active if the profile has visited the websit
 
 By default, a profile is considered engaged when the engagement time of the visitor was higher than 300 seconds in the last 3 sessions.
 
-The exact settings (30 days, 300 seconds, 3 sessions) can be overwritten via the [uMarketingSuite configuration file](/installing-umarketingsuite/configuration-options-1-x/).
+The exact settings (30 days, 300 seconds, 3 sessions) can be overwritten via the [uMarketingSuite configuration file](../../../../installing-umarketingsuite/configuration-options-1-x/).
 
 ## Calculated Persona & Customer Journey Phase
 
-Within the profile, you can see all [personas](/personalization/implicit-explicit-personalization/setting-up-personas/) and [customer journeys](/personalization/implicit-explicit-personalization/setting-up-the-customer-journey/) that you have setup within the uMarketingSuite. Each persona and customer journey phase displays a score. You can see if uMarketingSuite has assigned a persona or journey phase to this visitor. In the below example, you see that the uMarketingSuite has assigned the persona "Data & Privacy officer" to this visitor.
+Within the profile, you can see all [personas](../../../../personalization/implicit-explicit-personalization/setting-up-personas/) and [customer journeys](../../../../personalization/implicit-explicit-personalization/setting-up-the-customer-journey/) that you have set up within the uMarketingSuite. Each persona and customer journey phase displays a score. You can see if uMarketingSuite has assigned a persona or journey phase to this visitor. In the below example, you see that the uMarketingSuite has assigned the persona "Data & Privacy officer" to this visitor.
 
 ![]()
 
@@ -53,41 +53,41 @@ In the Activity tab, you can view all the activity of this visitor.
 
 For each session, you can see:
 
-- An icon indicating whether the uMarketingSuite enriched the visitor's experience (blue icon for A/B Test variant or personalized variant; grey icon if not).
-- The timestamp when the session was recorded.
-- Which device type was uesed.
-- The number of pages that where visited in this session.
-- The duration of the session.
-- How long the person was engaged.
-- The number of goals that was triggered.
-- The events that were triggered.
-- On which page the session started.
-- From which website the visitor came into your website.
+* An icon indicating whether the uMarketingSuite enriched the visitor's experience (blue icon for A/B Test variant or personalized variant; grey icon if not).
+* The timestamp when the session was recorded.
+* Which device type was used.
+* The number of pages that were visited in this session.
+* The duration of the session.
+* How long the person was engaged.
+* The number of goals that were triggered.
+* The events that were triggered.
+* On which page the session started.
+* From which website the visitor came into your website.
 
 By clicking on a row, you can access more detailed information about that session.
 
 ![]()
 
 You will see:
 
-- The visited page.
-- The time of visit.
-- The time on page.
-- The engaged time on page.
-- The scroll depth on that page.
-- The number of goals that where triggered.
-- The number of recorded events.
-- The variant of the page displayed to the visitor.
-- The operating system, browser, and (anonymized) IP address used.
-- An icon indicating whether the visitor saw a personalized or A/B tested variant of the page.
+* The visited page.
+* The time of visit.
+* The time on page.
+* The engaged time on page.
+* The scroll depth on that page.
+* The number of goals that were triggered.
+* The number of recorded events.
+* The variant of the page displayed to the visitor.
+* The operating system, browser, and (anonymized) IP address used.
+* An icon indicating whether the visitor saw a personalized or A/B tested variant of the page.
 
 Finally, you can drill down into the activity on a specific page:
 
 ![]()
 
 Here, you can see:
 
-- When the visitor started their visit on the page.
-- When the maximum scroll depth was reached.
-- When the visit ended.
-- When goals were triggered.
+* When the visitor started their visit on the page.
+* When the maximum scroll depth was reached.
+* When the visit ended.
+* When goals were triggered.

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

@@ -2,17 +2,17 @@
 
 **Disclaimer**: Always check you are GDPR compliant with your own privacy office or legal department
 
-The uMarketingSuite cares about privacy and values insights. We have turned this in a standard for you and your customer. Server-side analytics in combination with a 1st party cookie was never this easy to setup. And even better; **you own your data**. uMarketingSuite is granted the [Privacy Verified certificate](../../../../%7BlocalLink:umb:/media/b03954cbbf52461897be2cb509b6b690%7D/).
+The uMarketingSuite cares about privacy and values insights. We have turned this into a standard for you and your customer. Server-side analytics in combination with a 1st party cookie was never this easy to set up. And even better; **you own your data**. uMarketingSuite is granted the [Privacy Verified certificate](../../../../%7BlocalLink:umb:/media/b03954cbbf52461897be2cb509b6b690%7D/).
 
-**You can be GDPR compliant out-of-the-box!**
+**You can be GDPR compliant out of the box.**
 
 ## Privacy Verified Certificate
 
 [![]()](../../../../%7BlocalLink:umb:/media/b03954cbbf52461897be2cb509b6b690%7D/)You can [view our Privacy Verified Certificate](../../../../%7BlocalLink:umb:/media/b03954cbbf52461897be2cb509b6b690%7D/) which states the following:
 
 * uMarketingSolutions uses specific retention periods and personal data is not kept longer than necessary.
 * uMarketingSolutions has set up its software according to the principles of privacy by design and by default.
-* uMarketingSolutions correctly informs customers, by means of a white paper, of the obligation to inform about the use of uMarketingSuite.
+* uMarketingSolutions correctly informs customers, using a white paper, of the obligation to inform about the use of uMarketingSuite.
 * uMarketingSolutions informs its customers correctly, by means of a white paper, that permission is required for placing and reading the cookie from uMarketingSuite
 
 ## GDPR Whitepaper
@@ -28,7 +28,7 @@ uMarketingSuite has been designed with the principles of privacy by design and p
   (except for, for example, your own hosting provider), as the cookie is first\
   party.
 
-You have the possibility to change default settings. However, we do not recommend doing so, as they are set in line with the General Data Protection Regulation (hereinafter: GDPR).
+You can change the default settings. However, we do not recommend doing so, as they are set in line with the General Data Protection Regulation (hereinafter: GDPR).
 
 ### Information obligation
 
@@ -38,8 +38,8 @@ When using uMarketingSuite, this means that you, as a customer, have to inform a
 
 ### Cookie consent 🍪
 
-[The cookie of uMarketingSuite can be categorized as an analytical and personalization cookie in one](../../../../the-umarketingsuite-broad-overview/the-umarketingsuite-cookie/), as the cookie is used to analyse website visitor behaviour and to personalize the content of the website based on this behaviour. For analytical and personalization cookies consent is required, based on the GDPR and the ePrivacy Directive.
+[The cookie of uMarketingSuite can be categorized as an analytical and personalization cookie in one](../../../../the-umarketingsuite-broad-overview/the-umarketingsuite-cookie/), as the cookie is used to analyze website visitor behavior and to personalize the content of the website based on this behavior. For analytical and personalization cookies consent is required, based on the GDPR and the ePrivacy Directive.
 
 As a customer and the controller of the personal data processed by the use of uMarketingSuite, **it is your responsibility to obtain consent from the website visitor for the use of the uMarketingSuite cookie**. Consent can be obtained by means of a cookie banner.
 
-Following the GDPR whitepaper in combination with cookie consent, you [can control the features of uMarketingSuite and give your visitors total control over which features they wish to enable](../../../../the-umarketingsuite-broad-overview/the-umarketingsuite-cookie/module-permissions/), Analytics, A/B Testing or Personalizatio
+Following the GDPR whitepaper in combination with cookie consent, you [can control the features of uMarketingSuite and give your visitors total control over which features they wish to enable](../../../../the-umarketingsuite-broad-overview/the-umarketingsuite-cookie/module-permissions/), Analytics, A/B Testing, or Personalization.