docs(chat): Improve documentation and Add more links

pepinho24 · pepinho24 · commit b1bed960a8a4 · 2018-05-15T18:33:44.000+03:00
diff --git a/controls/chat/client-side-programming/events.md b/controls/chat/client-side-programming/events.md
@@ -14,7 +14,7 @@ position: 1
 
 * [OnActionClick]({%slug chat/client-side-programming/events/onactionclick%}) occurs when an action button is clicked inside an attachment template, or when a suggestedAction is clicked.
 
-* [OnInitialize]({%slug chat/client-side-programming/events/oninitialize%}) occurs when the **RadChat** starts initializing on the client-side.
+* [OnInitialize]({%slug chat/client-side-programming/events/oninitialize%}) occurs when the **RadChat** starts initializing on the client-side, before the underlying Kendo UI Chat widget is initialized.
 
 * [OnLoad]({%slug chat/client-side-programming/events/onload%}) occurs after the **RadChat** has been fully initialized on the client-side.
 
diff --git a/controls/chat/client-side-programming/events/onactionclick.md b/controls/chat/client-side-programming/events/onactionclick.md
@@ -36,5 +36,6 @@ The event handler receives two parameters:
 
  * [Kendo UI Chat Events](http://docs.telerik.com/kendo-ui/api/javascript/ui/chat#events)
 
- * [RadChat Client-side events Overview]({%slug chat/client-side-programming/events%})
+ * [RadChat Client-Side events Overview]({%slug chat/client-side-programming/events%})
 
+ * [RadChat Client-Side API Overview]({%slug chat/client-side-programming/overview%})
diff --git a/controls/chat/client-side-programming/events/oninitialize.md b/controls/chat/client-side-programming/events/oninitialize.md
@@ -10,7 +10,7 @@ position: 1
 
 # OnInitialize
 
-The **OnInitialize** client-side event occurs when the **RadChat** starts initializing on the client-side.
+The **OnInitialize** client-side event occurs when the **RadChat** starts initializing on the client-side, before the underlying Kendo UI Chat widget is initialized.
 
 The event handler receives one parameter:
 
@@ -31,6 +31,7 @@ The event handler receives one parameter:
 
  * [Kendo UI Chat Events](http://docs.telerik.com/kendo-ui/api/javascript/ui/chat#events)
 
- * [RadChat Client-side events Overview]({%slug chat/client-side-programming/events%})
+ * [RadChat Client-Side events Overview]({%slug chat/client-side-programming/events%})
 
+ * [RadChat Client-Side API Overview]({%slug chat/client-side-programming/overview%})
 
diff --git a/controls/chat/client-side-programming/events/onload.md b/controls/chat/client-side-programming/events/onload.md
@@ -35,7 +35,9 @@ This event is helpful if you need to get the client-side instance of the RadChat
 
  * [Kendo UI Chat Events](http://docs.telerik.com/kendo-ui/api/javascript/ui/chat#events)
 
- * [RadChat Client-side events Overview]({%slug chat/client-side-programming/events%})
+ * [RadChat Client-Side events Overview]({%slug chat/client-side-programming/events%})
 
  * [Connecting to Chat Bot Services]({%slug chat/how-to/configure-chat-agent%})
 
+ * [RadChat Client-Side API Overview]({%slug chat/client-side-programming/overview%})
+
diff --git a/controls/chat/client-side-programming/events/onpost.md b/controls/chat/client-side-programming/events/onpost.md
@@ -42,3 +42,5 @@ The event handler receives two parameters:
 
  * [RadChat Client-side events Overview]({%slug chat/client-side-programming/events%})
 
+ * [RadChat Client-Side API Overview]({%slug chat/client-side-programming/overview%})
+
diff --git a/controls/chat/client-side-programming/events/onsendmessage.md b/controls/chat/client-side-programming/events/onsendmessage.md
@@ -34,5 +34,6 @@ The event handler receives two parameters:
 
  * [Kendo UI Chat Events](http://docs.telerik.com/kendo-ui/api/javascript/ui/chat#events)
 
- * [RadChat Client-side events Overview]({%slug chat/client-side-programming/events%})
+ * [RadChat Client-Side events Overview]({%slug chat/client-side-programming/events%})
 
+ * [RadChat Client-Side API Overview]({%slug chat/client-side-programming/overview%})
diff --git a/controls/chat/client-side-programming/events/ontypingend.md b/controls/chat/client-side-programming/events/ontypingend.md
@@ -31,5 +31,6 @@ The event handler receives two parameters:
 
  * [Kendo UI Chat Events](http://docs.telerik.com/kendo-ui/api/javascript/ui/chat#events)
 
- * [RadChat Client-side events Overview]({%slug chat/client-side-programming/events%})
+ * [RadChat Client-Side events Overview]({%slug chat/client-side-programming/events%})
 
+ * [RadChat Client-Side API Overview]({%slug chat/client-side-programming/overview%})
diff --git a/controls/chat/client-side-programming/events/ontypingstart.md b/controls/chat/client-side-programming/events/ontypingstart.md
@@ -31,5 +31,6 @@ The event handler receives two parameters:
 
  * [Kendo UI Chat Events](http://docs.telerik.com/kendo-ui/api/javascript/ui/chat#events)
 
- * [RadChat Client-side events Overview]({%slug chat/client-side-programming/events%})
+ * [RadChat Client-Side events Overview]({%slug chat/client-side-programming/events%})
 
+ * [RadChat Client-Side API Overview]({%slug chat/client-side-programming/overview%})
diff --git a/controls/chat/client-side-programming/overview.md b/controls/chat/client-side-programming/overview.md
@@ -10,13 +10,15 @@ position: 0
 
 # Client-side Programming Overview
 
-The **RadChat** control is built on top of the [Kendo UI Chat](http://demos.telerik.com/kendo-ui/chat/index). This allows you to interact with the chat entirely on the client-side.
+The **RadChat** control is built on top of the [Kendo UI Chat](http://demos.telerik.com/kendo-ui/chat/index) widget. This allows you to interact with the chat entirely on the client-side.
 
 ## Getting the RadChat Client-side Object
 
-**RadChat** creates a client-side object, which can be referred via the **ClientID** of the control and the **$find** function. Then, you can access the actual object that exposes the API of the Kendo UI chat through the **get_kendoWidget** method of **RadChat**'s client-side object as shown in **Example 1**.
+**RadChat** creates a client-side object, which can be referred via the **ClientID** of the control and the **$find** function. This allows you to use the API of the RadChat client-side object. 
 
-When you have referenced the Kendo UI chat, you can utilize the [full capabilities of its API](http://docs.telerik.com/kendo-ui/api/javascript/ui/chat). 
+Once you obtain a reference to the [RadChat client-side object]({%slug chat/client-side-programming/objects/radchat%}), you can access the underlying Kendo UI Chat widget through the **get_kendoWidget** method as shown in **Example 1**.
+
+When you have a reference to the Kendo UI Chat widget, you can utilize the [API of the Kendo UI widget](http://docs.telerik.com/kendo-ui/api/javascript/ui/chat). 
 
 >caption  Example 1: Get a reference to the underlying Kendo UI Chat widget.
 ````JavaScript
@@ -28,7 +30,7 @@ var kendochat = radchat.get_kendoWidget();
 
  * [Kendo UI Chat API](http://docs.telerik.com/kendo-ui/api/javascript/ui/chat)
 
- * [RadChat Client-side Object]({%slug chat/client-side-programming/objects/radchat%})
+ * [RadChat Client-Side Object]({%slug chat/client-side-programming/objects/radchat%})
 
- * [Client-side events Overview]({%slug chat/client-side-programming/events%})
+ * [Client-Side events Overview]({%slug chat/client-side-programming/events%})
 
diff --git a/controls/chat/functionality/actions.md b/controls/chat/functionality/actions.md
@@ -10,7 +10,7 @@ position: 0
 
 # Default Actions
 
-Out of the box, the **RadChat** supports **suggested actions**. To display the **suggestedActions** propmt, manually call the `renderSuggestedActions` method of the control.
+The **RadChat** control has a support for default **suggested actions**. To display the **suggestedActions** propmt, you need to call  the `renderSuggestedActions` method of the control.
 
 ````ASPX
 <telerik:RadChat runat="server" ID="RadChat1">
@@ -38,8 +38,10 @@ function renderSuggestedActions() {
 
  * [RadChat Structure]({%slug chat/structure%})
 
- * [RadChat Server-Side Programming]({%slug diagram/server-side-programming%})
+ * [RadChat Server-Side Programming]({%slug chat/server-side-programming%})
 
  * [RadChat Client-Side Programming]({%slug chat/client-side-programming/overview%})
 
+ * [RadChat Online Demos](http://demos.telerik.com/aspnet-ajax/chat/overview/defaultcs.aspx)
+
  
diff --git a/controls/chat/functionality/cards.md b/controls/chat/functionality/cards.md
@@ -10,7 +10,7 @@ position: 1
 
 # Default Cards
 
-Out of the box, the **RadChat** supports **heroCards** which can be displayed in the chat flow by manually calling the `renderAttachments` method of the control.
+Out of the box, the **RadChat** supports the default **heroCards** which can be displayed in the chat flow when calling the `renderAttachments` method of the control.
 
 ````ASPX
 <telerik:RadChat runat="server" ID="RadChat1">
@@ -44,4 +44,6 @@ function renderAttachments() {
 
  * [RadChat Client-Side Programming]({%slug chat/client-side-programming/overview%})
 
+ * [RadChat Online Demos](http://demos.telerik.com/aspnet-ajax/chat/overview/defaultcs.aspx)
+
  
diff --git a/controls/chat/functionality/components.md b/controls/chat/functionality/components.md
@@ -11,7 +11,7 @@ position: 3
 # Custom Components
 
 
-The **RadChat** supports the implementation of custom components which allow you to use JavaScript to render any content.
+The **RadChat** control supports the implementation of custom components which allow you to use JavaScript to render any content.
 
 The following example demonstrates how to place a [Kendo UI Calendar](https://docs.telerik.com/kendo-ui/controls/scheduling/calendar/overview) in a custom RadChat component.
 
@@ -89,4 +89,6 @@ function addCustomComponent() {
 
  * [RadChat Client-Side Programming]({%slug chat/client-side-programming/overview%})
 
+ * [RadChat Online Demos](http://demos.telerik.com/aspnet-ajax/chat/overview/defaultcs.aspx)
+
  
diff --git a/controls/chat/functionality/templates.md b/controls/chat/functionality/templates.md
@@ -11,7 +11,7 @@ position: 2
 # Custom Templates
 
 
-The **RadChat** supports the definition of custom templates to fit any custom payload that is returned by the service.
+The **RadChat** control supports the definition of custom templates to fit any custom payload that is returned by the service.
 
 The following example demonstrates how to implement a simple [Kendo UI template](https://docs.telerik.com/kendo-ui/framework/templates/overview) and to register it for the **RadChat**.
 
@@ -83,4 +83,5 @@ function renderCustomTemplate() {
 
  * [Kendo UI Templates](https://docs.telerik.com/kendo-ui/framework/templates/overview)
 
+ * [RadChat Online Demos](http://demos.telerik.com/aspnet-ajax/chat/overview/defaultcs.aspx)
  
diff --git a/controls/chat/getting-started.md b/controls/chat/getting-started.md
@@ -18,7 +18,7 @@ The following tutorial demonstrates how you can add a simple **RadChat** control
 
 1. Add a **ScriptManager** control on a Web Form.
 
-1. Add a **RadDiagram** control on this AJAX-enabled Web Form: 
+1. Add a **RadChat** control on this Web Form: 
 	
 	>caption **Example 1**: Declaration of a **RadChat** control.
 
@@ -30,7 +30,7 @@ The following tutorial demonstrates how you can add a simple **RadChat** control
 
 
 
-1. Set some of the message and user settings like **Placeholder**, **Name** and **IconUrl**.
+1. Set some of the messages and user settings like **Placeholder**, **Name** and **IconUrl**.
 
 	>caption **Example 2**: The chat now has a custom placeholder message, username and avatar
 
@@ -93,9 +93,16 @@ The following tutorial demonstrates how you can add a simple **RadChat** control
     }
     ````
 
+
+
 # See Also
 
  * [RadChat Structure]({%slug chat/structure%})
 
+ * [RadChat Client-Side Programming]({%slug chat/client-side-programming/overview%})
+ 
  * [RadChat Server-Side Programming]({%slug chat/server-side-programming/overview%})
+
+ * [Connecting to a Chatbot Service]({%slug chat/how-to/configure-chat-agent%}) 
+
  
diff --git a/controls/chat/how-to/configure-chat-agent.md b/controls/chat/how-to/configure-chat-agent.md
@@ -10,11 +10,11 @@ position: 0
 
 # Connecting to Chat Bot Services
 
-To connect the [RadChat]({%slug chat/overview%}) to any service and render the responses from the service, utilize the post event of the control and its public API.
+To connect the [RadChat]({%slug chat/overview%}) control to any service and render the responses from the service, utilize the [post event](chat/client-side-programming/events/onpost) of the control and its [public client-side API](chat/client-side-programming/overview).
 
 ## Configure the Chat Agent
 
-To encapsulate the communication with the specific service, use an **agent** class. The **agent** class handles the communication with the external Chat Bot service. The establishment of the connection to the service and the binding of the appropriate events are done within the **init** method. In this way, the agent is able to receive the responses.
+To encapsulate the communication with the specific service, use an **agent** class. The **agent** class handles the communication with the external Chat Bot service. The establishment of the connection to the service and the binding of the appropriate events are done within the **init** method of the agent. In this way, the agent is able to receive the responses.
 
 The following example uses the [Microsoft Bot Framework](https://dev.botframework.com/). The **agent** is subscribed to listen for any **activity$** of the remote service. When an activity is detected, the appropriate method from the Chat public API is invoked to render the data. To handle the user input, the example implements the **post** event handler of the Chat and the arguments are passed to the Chat Bot service.
 
@@ -87,16 +87,12 @@ var DirectLineAgent = kendo.Class.extend({
 
 ````JavaScript
 function onLoad(sender, args) {
-    console.log("load");
-
     // Create a new agent and pass the Chat control
     // The agent is available in the Chat control
     sender.agent = new DirectLineAgent(sender, "Y_ly-If6haE.cwA.PQE.ZwOOsq4MlHcD3_YLFI-t9oW6L6DXMMBoi67LBz9WaWA");
 }
 
 function onSendMessage(sender, args) {
-    console.log("send");
-
     var postArgs = {
         text: args.get_text()
     };
@@ -122,5 +118,7 @@ function onPost(sender, args) {
 
  * [RadChat Travel](http://demos.telerik.com/aspnet-ajax/chat/travel/defaultcs.aspx) online demo
 
+ * [RadChat Client-Side Programming]({%slug chat/client-side-programming/overview%})
+
  
 
diff --git a/controls/chat/overview.md b/controls/chat/overview.md
@@ -14,6 +14,8 @@ position: 0
 
 This article provides a brief overview of the main features of the **RadChat** control.
 
+* **[Flexible client-side API]({%slug chat/client-side-programming/overview%})** - The flexible API allows an easy integration with Chatbot services.
+
 * **[Default Cards]({%slug chat/functionality/cards%})** - Built-in support for heroCards which can be displayed in the chat flow.
 
 * **[Default Actions]({%slug chat/functionality/actions%})** - Out-of-the-box support for suggested actions.
@@ -22,7 +24,11 @@ This article provides a brief overview of the main features of the **RadChat** c
 
 * **[Custom Components]({%slug chat/functionality/components%})** - Integration of custom components, which allows the use of JavaScript to render any content.
 
+
 # See Also
 
  * [RadChat Online Demos](http://demos.telerik.com/aspnet-ajax/chat/overview/defaultcs.aspx)
 
+ * [Connecting to a Chatbot Service]({%slug chat/how-to/configure-chat-agent%})
+
+

Original file line number	Diff line number	Diff line change
`@@ -42,3 +42,5 @@ The event handler receives two parameters:`
`42`	`42`
`43`	`43`	`* [RadChat Client-side events Overview]({%slug chat/client-side-programming/events%})`
`44`	`44`
	`45`	`+ * [RadChat Client-Side API Overview]({%slug chat/client-side-programming/overview%})`
	`46`	`+`