comment document added and review other documents

docs/en/Modules/Cms-Kit.md

@@ -2,12 +2,12 @@
 
 This module provides CMS(Content Management System) capabilities for your application.
 
-* Provides a **page** management system to manage dynamic pages.
-* Provides a **blog** system to create blogs and publish posts.
-* Provides a **tag** system to tag any kind of resources, like blog posts.
-* Provides a **comment** system to add comments feature to any kind of resource, like blog posts.
-* Provides a **reaction** system to add reactions feature to any kind of resource, like blog posts or comments.
-* Provides a **rating** system to add ratings feature to any kind of resource.
+* Provides a [**page**](cms-kit/) management system to manage dynamic pages.
+* Provides a [**blog**](cms-kit/) system to create blogs and publish posts.
+* Provides a [**tag**](cms-kit/Tag-Management.md) system to tag any kind of resources, like blog posts.
+* Provides a [**comment**](cms-kit/Comment-System.md) system to add comments feature to any kind of resource, like blog posts, products, etc.
+* Provides a [**reaction**](cms-kit/Reaction-System.md) system to add reactions feature to any kind of resource, like blog posts or comments.
+* Provides a [**rating**](cms-kit/Rating-System.md) system to add rating feature to any kind of resource.
 
 ## How to install
 
@@ -38,9 +38,9 @@ For example,
  - `Volo.CmsKit.Public.Application`: Contains functionality required by public websites.
  - `Volo.CmsKit.Application` : Unified package dependent on both public and admin packages.
 
-If you want to want to separate admin and public website codes, you can use the admin and public packages. However, if you want to keep admin and public website codes in a shared project, you can use the unified packages to include both admin and public packages. 
+If you want to separate admin and public website codes, you can use the admin and public packages. However, if you want to keep admin and public website codes in a shared project, you can use the unified packages to include admin and public packages. 
 
-It is recommeded to use the unified packages instead of adding both admin and public packages.
+It is recommended to use the unified packages instead of adding both admin and public packages.
 
 ## Feature System
 
@@ -154,6 +154,6 @@ You can also customize the reaction icons shown in the reaction component.
 
 ### Ratings
 
-You can use the rating component to add rating a mechanism to your content. Here how the rating component looks on  a sample page.
+You can use the rating component to add rating a mechanism to your content. Here how the rating component looks on a sample page.
 
 ![ratings](../images/cmskit-module-ratings.png)

docs/en/Modules/cms-kit/Comment-System.md

@@ -0,0 +1,117 @@
+# Comment System
+
+CMS kit provides a **rating** system to add comments feature to any kind of resource, like blog posts, products, etc. This section describes the details of the comments system.
+
+## Feature
+
+CMS kit uses the [global feature](https://docs.abp.io/en/abp/latest/Global-Features) system for all implemented features. Commercial startup templates come with all the CMS kit related features are enabled by default, if you create the solution with public website option. If you're installing the CMS kit manually or want to enable the comment feature individually, open the `GlobalFeatureConfigurator` class in the `Domain.Shared` project and place the following code to the `Configure ` method.
+
+```csharp
+GlobalFeatureManager.Instance.Modules.CmsKit(cmsKit =>
+{
+    cmsKit.Comments.Enable();
+});
+```
+
+# Options
+
+## CmsKitCommentOptions
+
+You can use the comment system to add comments to any kind of resources, like blog posts, products etc. Comment system provides a mechanism to group comment definitions by entity types. For example, if you want to use comment system for blog posts and products, you need to define two entity types named `BlogPosts` and `Product`, and add comments under these entity types.
+
+`CmsKitCommentOptions` can be configured in the domain layer, in the `ConfigureServices` method of your [module](https://docs.abp.io/en/abp/latest/Module-Development-Basics). Example:
+
+```csharp
+Configure<CmsKitCommentOptions>(options =>
+{
+    options.EntityTypes.Add(new CommentEntityTypeDefinition("Product"));
+});
+```
+
+> If you're using the blog feature, the ABP framework defines an entity type for the blog feature automatically. You can easily override or remove the predefined entity types in `Configure` method like shown above.
+
+`CmsKitCommentOptions` properties:
+
+- `EntityTypes`: List of defined entity types(`CmsKitCommentOptions`) in the comment system.
+
+`CommentEntityTypeDefinition` properties:
+
+- `EntityType`: Name of the entity type.
+
+# Internals
+
+## Domain Layer
+
+#### Aggregates
+
+This module follows the [Entity Best Practices & Conventions](https://docs.abp.io/en/abp/latest/Best-Practices/Entities) guide.
+
+##### Comment
+
+A comment represents a written comment from a user.
+
+- `Comment` (aggregate root): Represents a written comment in the system.
+
+#### Repositories
+
+This module follows the [Repository Best Practices & Conventions](https://docs.abp.io/en/abp/latest/Best-Practices/Repositories) guide.
+
+Following custom repositories are defined for this feature:
+
+- `ICommentRepository`
+
+#### Domain services
+
+This module follows the [Domain Services Best Practices & Conventions](https://docs.abp.io/en/abp/latest/Best-Practices/Domain-Services) guide.
+
+##### Comment Manager
+
+`CommentManager` is used to perform some operations for the `Comment` aggregate root.
+
+### Application layer
+
+#### Application services
+
+- `CommentAdminAppService` (implements `ICommentAdminAppService`): Implements the use cases of comment management system, like listing or removing comments etc.
+- `CommentPublicAppService` (implements `ICommentPublicAppService`):  Implements the use cases of comment management on the public websites, like listing comments, adding comments etc.
+
+### Database providers
+
+#### Common
+
+##### Table / collection prefix & schema
+
+All tables/collections use the `Cms` prefix by default. Set static properties on the `CmsKitDbProperties` class if you need to change the table prefix or set a schema name (if supported by your database provider).
+
+##### Connection string
+
+This module uses `CmsKit` for the connection string name. If you don't define a connection string with this name, it fallbacks to the `Default` connection string.
+
+See the [connection strings](https://docs.abp.io/en/abp/latest/Connection-Strings) documentation for details.
+
+#### Entity Framework Core
+
+##### Tables
+
+- CmsComments
+
+#### MongoDB
+
+##### Collections
+
+- **CmsComments**
+
+### MVC UI
+
+The comment system provides a commenting widget to allow users to send comments to resources on public websites. You can simply place the widget to the like below. 
+
+```csharp
+@await Component.InvokeAsync(typeof(CommentingViewComponent), new
+{
+  entityType = "entityType",
+  entityId = "entityId"
+})
+```
+You need to specify entity type and entity ID parameters. Entity type represents the group name you specified while defining the comments in the domain module. Entity ID represents the unique identifier for the resource that users send comments to, such as blog post ID or product ID.
+
+For more information about widgets see [widgets](https://docs.abp.io/en/abp/latest/UI/AspNetCore/Widgets) documentation.

docs/en/Modules/cms-kit/Rating-System.md

@@ -1,10 +1,10 @@
 # Rating System
 
-CMS kit provides a **rating** system to to add ratings feature to any kind of resource like blog posts, comments etc. This section describes the details of the rating system. 
+CMS kit provides a **rating** system to to add ratings feature to any kind of resource like blog posts, comments, etc. This section describes the details of the rating system. 
 
 ## Feature
 
-CMS kit uses the [global feature](https://docs.abp.io/en/abp/latest/Global-Features) system for all implemented features. Commercial startup templates come with all the CMS kit related features are enabled by default, if you create the solution with the public website option. If you're installing the CMS kit manually or want to enable rating feature individually, open the `GlobalFeatureConfigurator` class in the `Domain.Shared` project and place the following code to the `Configure ` method.
+CMS kit uses the [global feature](https://docs.abp.io/en/abp/latest/Global-Features) system for all implemented features. Commercial startup templates come with all the CMS kit related features are enabled by default, if you create the solution with the public website option. If you're installing the CMS kit manually or want to enable the rating feature individually, open the `GlobalFeatureConfigurator` class in the `Domain.Shared` project and place the following code to the `Configure ` method.
 
 ```csharp
 GlobalFeatureManager.Instance.Modules.CmsKit(cmsKit =>
@@ -17,7 +17,7 @@ GlobalFeatureManager.Instance.Modules.CmsKit(cmsKit =>
 
 ## CmsKitRatingOptions
 
-You can use the rating system to to add ratings to any kind of resource, like blog posts or comments etc.The rating system provides a mechanism to group ratings by entity types. For example, if you want to use rating system for products, you need to define a entity type named `Product`, and then add ratings under the defined entity type.
+You can use the rating system to to add ratings to any kind of resource, like blog posts, comments, etc. The rating system provides a mechanism to group ratings by entity types. For example, if you want to use the rating system for products, you need to define an entity type named `Product` and then add ratings under the defined entity type.
 
 `CmsKitRatingOptions` can be configured in the domain layer, in the `ConfigureServices` method of your [module](https://docs.abp.io/en/abp/latest/Module-Development-Basics). Example:
 
@@ -34,7 +34,7 @@ Configure<CmsKitRatingOptions>(options =>
 
 - `EntityTypes`: List of defined entity types(`RatingEntityTypeDefinition`) in the rating system.
 
-`RatingEntityTypeDefinition` properties:asdas
+`RatingEntityTypeDefinition` properties:
 
 - `EntityType`: Name of the entity type.
 
@@ -111,6 +111,6 @@ The ratings system provides a rating widget to allow users send ratings to resou
   entityId = "entityId"
 })
 ```
-You need to specify entity type and entity ID parameters. Entity type represents the group name you specified while defining the reactions in the domain module. Entity ID represents the unique identifier for the resource that users give ratings to such as blog post ID or product ID.
+You need to specify entity type and entity ID parameters. Entity type represents the group name you specified while defining the reactions in the domain module. Entity ID represents the unique identifier for the resource that users give ratings to, such as blog post ID or product ID.
 
 For more information about widgets see [widgets](https://docs.abp.io/en/abp/latest/UI/AspNetCore/Widgets) documentation.

docs/en/Modules/cms-kit/Reaction-System.md

@@ -17,7 +17,7 @@ GlobalFeatureManager.Instance.Modules.CmsKit(cmsKit =>
 
 ## CmsKitReactionOptions
 
-You can use the reaction system to to add reactions feature to any kind of resource, like blog posts or comments etc.The reaction system provides a mechanism to group reactions by entity types. For example, if you want to use reaction system for products, you need to define a entity type named `Product`, and then add reactions under the defined entity type.
+You can use the reaction system to to add reactions feature to any kind of resource, like blog posts or comments, etc. The reaction system provides a mechanism to group reactions by entity types. For example, if you want to use the reaction system for products, you need to define an entity type named `Product`, and then add reactions under the defined entity type.
 
 `CmsKitReactionOptions` can be configured in the domain layer, in the `ConfigureServices` method of your [module](https://docs.abp.io/en/abp/latest/Module-Development-Basics). Example:
 
@@ -34,13 +34,7 @@ Configure<CmsKitReactionOptions>(options =>
                 new ReactionDefinition(StandardReactions.ThumbsDown),
                 new ReactionDefinition(StandardReactions.Confused),
                 new ReactionDefinition(StandardReactions.Eyes),
-                new ReactionDefinition(StandardReactions.Heart),
-                new ReactionDefinition(StandardReactions.HeartBroken),
-                new ReactionDefinition(StandardReactions.Wink),
-                new ReactionDefinition(StandardReactions.Pray),
-                new ReactionDefinition(StandardReactions.Rocket),
-                new ReactionDefinition(StandardReactions.Victory),
-                new ReactionDefinition(StandardReactions.Rock),
+                new ReactionDefinition(StandardReactions.Heart)
             }));
 });
 ```
@@ -120,7 +114,7 @@ See the [connection strings](https://docs.abp.io/en/abp/latest/Connection-String
 
 ### MVC UI
 
-The reaction system provides a reaction widget to allow users send reactions to resources in public websites. You can simply place the widget to the like below. 
+The reaction system provides a reaction widget to allow users to send reactions to resources on public websites. You can place the widget on a page like below. 
 
 ```csharp
 @await Component.InvokeAsync(typeof(ReactionSelectionViewComponent), new
@@ -129,6 +123,6 @@ The reaction system provides a reaction widget to allow users send reactions to
   entityId = "entityId"
 })
 ```
-You need to specify entity type and entity ID parameters. Entity type represents the group name you specified while defining the reactions in the domain module. Entity ID represents the unique identifier for the resource that users give reactions to such as blog post ID or product ID.
+You need to specify entity type and entity ID parameters. Entity type represents the group name you specified while defining the reactions in the domain module. Entity ID represents the unique identifier for the resource that users give reactions to, such as blog post ID or product ID.
 
 For more information about widgets see [widgets](https://docs.abp.io/en/abp/latest/UI/AspNetCore/Widgets) documentation.

docs/en/Modules/cms-kit/Tag-Management.md

@@ -4,7 +4,7 @@ CMS kit provides a **tag** system to tag any kind of resources, like blog posts.
 
 ## Feature
 
-CMS kit uses the [global feature](https://docs.abp.io/en/abp/latest/Global-Features) system for all implemented features. Commercial startup templates come with all the CMS kit related features are enabled by default, if you create the solution with public website option. If you're installing the CMS kit manually or want to enable tag management feature individually, open the `GlobalFeatureConfigurator` class in the `Domain.Shared` project and place the following code to the `Configure ` method.
+CMS kit uses the [global feature](https://docs.abp.io/en/abp/latest/Global-Features) system for all implemented features. Commercial startup templates come with all the CMS kit related features are enabled by default, if you create the solution with public website option. If you're installing the CMS kit manually or want to enable the tag management feature individually, open the `GlobalFeatureConfigurator` class in the `Domain.Shared` project and place the following code to the `Configure ` method.
 
 ```csharp
 GlobalFeatureManager.Instance.Modules.CmsKit(cmsKit =>
@@ -17,17 +17,19 @@ GlobalFeatureManager.Instance.Modules.CmsKit(cmsKit =>
 
 ## CmsKitTagOptions
 
-You can use the tag system to tag any kind of resources, like blog posts, products etc. Tag system provides a mechanism to group tags by entity types. For example, if you want to use tag system for blog posts and products, you need to define two entity types named BlogPosts and Product, and add tags under these entity types.
+You can use the tag system to tag any kind of resources, like blog posts, products, etc. The tag system provides a mechanism to group tags by entity types. For example, if you want to use the tag system for blog posts and products, you need to define two entity types named `BlogPosts` and `Product` and add tags under these entity types.
 
 `CmsKitTagOptions` can be configured in the domain layer, in the `ConfigureServices` method of your [module](https://docs.abp.io/en/abp/latest/Module-Development-Basics). Example:
 
 ```csharp
 Configure<CmsKitTagOptions>(options =>
 {
-    //Set options here...
+    options.EntityTypes.Add(new TagEntityTypeDefiniton("Product"));
 });
 ```
 
+> If you're using the blog feature, the ABP framework defines an entity type for the blog feature automatically. You can easily override or remove the predefined entity types in `Configure` method like shown above.
+
 `CmsKitTagOptions` properties:
 
 - `EntityTypes`: List of defined entity types(`TagEntityTypeDefiniton`) in the tag system. 
@@ -120,7 +122,7 @@ See the [connection strings](https://docs.abp.io/en/abp/latest/Connection-String
 
 ### MVC UI
 
-Tag system provides a tag widget to display associated tags of the resource in public websites. You can simply place the widget to the like below. 
+The tag system provides a tag widget to display associated tags of the resource on public websites. You can simply place the widget on a page like below. 
 
 ```csharp
 @await Component.InvokeAsync(typeof(TagViewComponent), new