updated entity history documents

Author: ismcagdas

docs/en/Features-Angular-Entity-History.md

@@ -8,14 +8,18 @@ When we click the magnifier icon, we can see all the details about a change log:
 
 <img src="images/entity-history-log-detail.png" alt="Change Log Detail" class="img-thumbnail" />
 
-You should add entity type that you want to track to ***.Core\EntityHistory\EntityHistoryHelper.TrackedTypes**.  And make sure you uncomment following lines in ***.EntityFrameworkCore\EntityFrameworkCore\{YourProjectName}EntityFrameworkCoreModule.cs**
+You should add entity type that you want to track to ***.Core\EntityHistory\EntityHistoryHelper.TrackedTypes**.  Make sure you uncomment following lines in ***.EntityFrameworkCore\EntityFrameworkCore\{YourProjectName}EntityFrameworkCoreModule.cs** and set **Configuration.EntityHistory.IsEnabled** to **true**.
 
 ```csharp
-//Configuration.EntityHistory.Selectors.Add("AbpZeroTemplateEntities", EntityHistoryHelper.TrackedTypes);
-//Configuration.CustomConfigProviders.Add(new EntityHistoryConfigProvider(Configuration));
+// Set this setting to true for enabling entity history.
+Configuration.EntityHistory.IsEnabled = false;
+
+// Uncomment below line to write change logs for the entities below:
+// Configuration.EntityHistory.Selectors.Add("AbpZeroTemplateEntities", EntityHistoryHelper.TrackedTypes);
+// Configuration.CustomConfigProviders.Add(new EntityHistoryConfigProvider(Configuration));
 ```
 
-The first line here adds entity types defined in `EntityHistoryHelper.TrackedTypes` to entity history config, so changes on those entities will be recorded. The second line adds a custom config provider to `CustomConfigProviders` list. ASP.NET Zero executes `GetConfig` method of each `CustomConfigProvider` and returns the result of `GetConfig` to Angular client app. 
+The first commented line here adds entity types defined in `EntityHistoryHelper.TrackedTypes` to entity history config, so changes on those entities will be recorded. The second commented line adds a custom config provider to `CustomConfigProviders` list. ASP.NET Zero executes `GetConfig` method of each `CustomConfigProvider` and returns the result of `GetConfig` to Angular client app. 
 
 So, in this particular case, `EntityHistoryConfigProvider` returns if entity history feature is enabled or not and if enabled, it returns list of entities enabled for entity history. Angular client app uses those information to show entity history related buttons on each entity page.
 

docs/en/Features-Mvc-Core-Entity-History.md

@@ -2,18 +2,49 @@
 
 In change logs under audit logs menu, we can see all change logs (entity history) in the application:
 
-<img src="images/entity-history-logs.png" alt="Change Logs" class="img-thumbnail" />
+<img src="D:/Github/documents/docs/en/images/change-logs-core.png" alt="Change Logs" class="img-thumbnail" />
 
-When we click the magnifier icon, we can see all details a change log. We can see which properties are changed.
+When we click the magnifier icon, we can see all the details about a change log:
 
-<img src="images/entity-history-log-detail.png" alt="Change Log Detail" class="img-thumbnail" />
+<img src="D:/Github/documents/docs/en/images/entity-history-log-detail.png" alt="Change Log Detail" class="img-thumbnail" />
 
-You should add entity type that you want to track to `*.Core\EntityHistory\EntityHistoryHelper.TrackedTypes`. And make sure you uncomment following line in `*.EntityFrameworkCore\EntityFrameworkCore\YourProjectNameEntityFrameworkCoreModule.cs`
+You should add entity type that you want to track to ***.Core\EntityHistory\EntityHistoryHelper.TrackedTypes**.  Make sure you uncomment following lines in ***.EntityFrameworkCore\EntityFrameworkCore\{YourProjectName}EntityFrameworkCoreModule.cs** and set **Configuration.EntityHistory.IsEnabled** to **true**.
 
 ```csharp
-//Configuration.EntityHistory.Selectors.Add("AbpZeroTemplateEntities", EntityHistoryHelper.TrackedTypes);
+// Set this setting to true for enabling entity history.
+Configuration.EntityHistory.IsEnabled = false;
+
+// Uncomment below line to write change logs for the entities below:
+// Configuration.EntityHistory.Selectors.Add("AbpZeroTemplateEntities", EntityHistoryHelper.TrackedTypes);
+// Configuration.CustomConfigProviders.Add(new EntityHistoryConfigProvider(Configuration));
+```
+
+The first commented line here adds entity types defined in `EntityHistoryHelper.TrackedTypes` to entity history config, so changes on those entities will be recorded. The second commented line adds a custom config provider to `CustomConfigProviders` list. ASP.NET Zero executes `GetConfig` method of each `CustomConfigProvider` and returns the result of `GetConfig` to Angular client app. 
+
+So, in this particular case, `EntityHistoryConfigProvider` returns if entity history feature is enabled or not and if enabled, it returns list of entities enabled for entity history. Angular client app uses those information to show entity history related buttons on each entity page.
+
+For example, when entity history is enabled for an Entity, Angular client shows history dropdown menu item for each entity record on the related page. Here is a sample screenshot for role list:
+
+<img src="D:/Github/documents/docs/en/images/change-logs-history-action-item.png" alt="Entity History Action" class="img-thumbnail" />
+
+In this way, history of an entity can be retrieved both on change logs tab in audit logs page or on the list page of the entity itself.
+
+The entity history config can be accessed on the Angular app like below:
+
+```javascript
+abp.custom.EntityHistory
 ```
 
+The abp.custom.EntityHistory object contains properties below:
+
+- **isEnabled**: Boolean field represents if entity history is enabled or not.
+- **enabledEntities**: Array of string contains full name of entity types entity history is enabled for.
+
+Here is a sample screenshot which show the value of **abp.custom.EntityHistory**:
+
+<img src="D:/Github/documents/docs/en/images/change-logs-custom-config-result-core.png" alt="Entity history custom config" class="img-thumbnail" />
+
+
 ## Next
 
 - [Subscription](Features-Mvc-Core-Subscription)