GITBOOK-51: Re-review of new article

Author: Sofie Toft Kristensen

13/umbraco-engage/.gitbook/assets/image (14).png

@@ -1,5 +1,6 @@
 ---
 description: Learn how data from Umbraco Forms is tracked with Umbraco Engage.
+icon: square-exclamation
 ---
 
 # Extending forms

13/umbraco-engage/developers/analytics/forms.md

@@ -3,6 +3,7 @@ description: >-
   Sometimes you need more fine-grained personalization for your website. For
   this purpose the Umbraco Engage exposes a service called the
   IAnalyticsStateProvider.
+icon: square-exclamation
 ---
 
 # Retrieve segment information from code
@@ -34,7 +35,6 @@ The `PageView` lies at the heart of Umbraco Engage Analytics feature and exposes
 Consider the following example (continued from above) where the content of content type "`Home`" was requested. We will now tell Umbraco to execute this custom code whenever the template `HomeTemplate` is requested:
 
 {% code overflow="wrap" %}
-
 ```csharp
 public ActionResult HomeTemplate()
 {
@@ -49,7 +49,6 @@ public ActionResult HomeTemplate()
     ...
 }
 ```
-
 {% endcode %}
 
 We can for example check if the current visitor falls into a segment called "**MySegment**". Keep in mind that a visitor can fall into any number of segments (zero, one, or all). A segment alone don't anything and can be regarded as purely informational, or as a "**Flag**" or "**Label**".
@@ -61,14 +60,12 @@ A page request can have only **one** active Applied Personalization. Based on th
 To inspect the resolved Applied Personalization, we can use the property `AppliedPersonalization` on the state's **PageView**:
 
 {% code overflow="wrap" %}
-
 ```csharp
 if (analyticsState.Pageview.AppliedPersonalization != null && analyticsState.Pageview.AppliedPersonalization.Name == "MyAppliedPersonalization")
 {
     ...
 }
 ```
-
 {% endcode %}
 
 Be aware that no personalization may have been resolved for the current request. Make sure to do a **null check** before reading the `AppliedPersonalization` property. The property `SegmentId` will tell you which active segment was responsible for triggering the Applied Personalization.

13/umbraco-engage/developers/personalization/segment-information.md

@@ -6,15 +6,15 @@ description: >-
 
 # Troubleshooting installations
 
-### Issue: Boot failure after initial installation
+## Boot failure after initial installation
 
-#### Description:
+### Description
 
-After installing Umbraco Engage and booting for the first time the following exception can be thrown. Due to not always known reasons Umbraco Engage fails to run the necessary migrations on startup and (probably) the Umbraco Engage tables are not created.
+After installing Umbraco Engage and booting for the first time the following exception can be thrown. Due to unknown reasons, Umbraco Engage fails to run the necessary migrations on startup, and the Umbraco Engage tables are not created.
 
-#### Error message:
+### Error message
 
-```
+```bash
 SqlException: Invalid object name 'umbracoEngageAbTestingAbTest'.
 Umbraco.Engage.Data.AbTesting.DbAbTestRepository.Query(Expression<Func<DbAbTest, bool>> whereExpression) in DbAbTestRepository.cs
 Umbraco.Engage.Data.AbTesting.DbAbTestRepository.GetAll() in DbAbTestRepository.cs
@@ -31,8 +31,8 @@ Program.<Main>$(string[] args) in Program.cs
 await app.BootUmbracoAsync();
 ```
 
-#### Steps to resolve:
+### Steps to resolve
 
-1. Remove the row with `Umbraco.Core.Upgrader.State+Umbraco.Engage` key from the `umbracoKeyValue` table in the database.&#x20;
-2. If they exist, remove all umbracoEngage\* tables from the database.&#x20;
+1. Remove the row with the `Umbraco.Core.Upgrader.State+Umbraco.Engage` key from the `umbracoKeyValue` table in the database.&#x20;
+2. Remove all existing umbracoEngage\* tables from the database.
 3. Restart the site.

13/umbraco-engage/getting-started/for-developers/troubleshooting-installations.md

@@ -3,6 +3,7 @@ description: >-
   Umbraco Engage provides the ability to continuously monitor the A/B tests you
   are running on your website. It is recommended to disable tests that perform
   poorly.
+icon: square-exclamation
 ---
 
 # Monitor the A/B Test

13/umbraco-engage/marketers-and-editors/ab-testing/monitor-the-ab-test.md

@@ -3,6 +3,7 @@ description: >-
   To set up an A/B test in Umbraco Engage you need to go through a series of
   steps. Learn more about the required configuration is required for initating a
   test.
+icon: square-exclamation
 ---
 
 # Setting up the A/B Test

13/umbraco-engage/marketers-and-editors/ab-testing/setting-up-the-ab-test.md

@@ -2,6 +2,7 @@
 description: >-
   Umbraco Engage enables running A/B tests on pages using a specified Document
   Type. This article covers how and when to use this type of test.
+icon: square-exclamation
 ---
 
 # Document Type Test

13/umbraco-engage/marketers-and-editors/ab-testing/types-of-ab-tests/document-type-test.md

@@ -2,6 +2,7 @@
 description: >-
   Umbraco Engage provides the option to run A/B tests across multiple pages.
   This article covers how and when to use this type of test.
+icon: square-exclamation
 ---
 
 # Multiple Pages Test

13/umbraco-engage/marketers-and-editors/ab-testing/types-of-ab-tests/multiple-pages-test.md

@@ -1,5 +1,6 @@
 ---
 description: Learn how data from Umbraco Forms is tracked with Umbraco Engage.
+icon: square-exclamation
 ---
 
 # Forms

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

@@ -1,5 +1,6 @@
 ---
 description: This article describes what data is tracked from videos on your website.
+icon: square-exclamation
 ---
 
 # Videos
@@ -12,7 +13,7 @@ Umbraco Engage gathers video statistics for the following types of videos:
 {% hint style="info" %}
 Make sure the embed URL contains `?enablejsapi=1` as part of the full URL to enable tracking. The `src` property of the iframe should be something like: `https://www.youtube.com/embed/<CODE>?enablejsapi=1`.
 
-The [https://www.youtube.com/iframe_api](https://www.youtube.com/iframe_api) is loaded for this purpose.
+The [https://www.youtube.com/iframe\_api](https://www.youtube.com/iframe_api) is loaded for this purpose.
 {% endhint %}
 
 * Embedded Vimeo videos
@@ -39,7 +40,7 @@ For the videos, the following information is gathered:
 Apart from the metadata above we also track actions performed on the video player. These actions are:
 
 | Action   | Description                                    |
-|----------|------------------------------------------------|
+| -------- | ---------------------------------------------- |
 | Autoplay | If the video was started automatically.        |
 | Play     | When the video starts playing.                 |
 | Pause    | When the video is paused.                      |