We use cookies to give you the best experience on our website. If you continue to browse, then you agree to our privacy policy and cookie policy.
Unfortunately, activation email could not send to your email. Please try again.
Syncfusion Feedback

Expanded Documentation with more examples

Thread ID:

Created:

Updated:

Platform:

Replies:

127162 Oct 26,2016 02:22 PM UTC Oct 31,2016 11:29 AM UTC General Discussion 4
loading
Tags: General Discussion
dan
Asked On October 26, 2016 02:22 PM UTC

First, you all are awesome at responding quickly to forum requests and providing great examples, Thanks!!!

If you expand your docs with more detailed examples, not just local but remote as well, it will help users and cut down on forum requests  

As an example that took me alot of time to figure out was dealing with Custom Adapters, there is just not enough documentation and very simple examples to easily understand.  Examples are only local, remote custom adapter examples would be great.

Let's take the below scenario where more examples and expanded docs would have helped.

Using your UrlAdapter with a query statement below, how do you know what the json format of the Request Payload Posted to the server? 
var query = ej.Query().take(7);
Example:  The UrlAdapter would POST  {take: 7, params: {}} in the Request Payload.  My server on the other hand expects the below json object to be sent
{take:7} with no params object. This is just an example of what my server expects but it could be any format, just like your ODataAdaptor which extends the UrlAdapte 
to change the way and json format of data that is Posted to the server. So more doc's explaining the format of json posted use a particular Adapter and 
expected json format the datamanager expects to receive. 
 
More detailed examples of creating a Custom Adapter's that connects to a remote api, Overriding processQuery or any other method to change they way/format of data 
that is sent/received to the server.

Without looking at ej.data.js you do not know any of the methods of the Adapter prototype or the methods of the UrlAdapter which extends and overrides methods such as 
processQuery, processResponse, beforSend, update, ect. Adding the Adapter prototype and your built-in Adapters to your API docs with detailed explanations of the 
the methods for each adapter and why/how they are used will help users understand how to create Custom Adapters. This is just my example problem, where expanded docs
and examples would have helped.

By taking more of the forum answers with the code examples you provide and incorporating them into your docs would also cut down on forum questions.

Thanks for a great product and awesome support!


Prince Oliver [Syncfusion]
Replied On October 27, 2016 09:21 AM UTC

Hi Dan,   
  
Thanks for your suggestion.   
  
We are working on providing better documentation with detailed examples. We will roll out the changes in one of the upcoming releases once the documentation work and reviews are completed. We will let you know when it is refreshed online.   
  
Regards,   
Prince 


dan
Replied On October 30, 2016 03:04 PM UTC

One additional suggestion would be to add accepted answer to your forums questions as well as a voting sytem for questions.

1) Accepted answers help users narrow down what they think will help resolve their problem.

2) Voting helps you determine what questions are more important to your users which in turns helps you decide if the question should be included in your docs.

dan
Replied On October 30, 2016 03:14 PM UTC

Also being able to edit your post if you make a mistake or need to clarify it, instead of having to submit a new reply just to update your post. Being able to change the question title if necessary again clarifying what the post is about for other users looking for answers.

Administrator [Syncfusion]
Replied On October 31, 2016 11:29 AM UTC

Hi Dan,   
Thanks for your suggestions.   
We will take note of these suggestions as a feature request for Forum Support System improvements. We will check the possibilities and roll out the features (Accepted Answers, Voting System and Edit forum post) in one of our upcoming website releases.   
Regards,   
Mathan Kumar H. J.   


CONFIRMATION

This post will be permanently deleted. Are you sure you want to continue?

Sorry, An error occured while processing your request. Please try again later.

Warning Icon You are using an outdated version of Internet Explorer that may not display all features of this and other websites. Upgrade to Internet Explorer 8 or newer for a better experience.Close Icon

;