ListView documentation missing information

[Josh]

You may already know this by now, but the ListView documentation is missing information and the examples show different information and even have unused code.

For paging, this example doesn't use the "pageable" property, yet somehow has paging:
http://demos.kendoui.com/web/listview/index.html

This one calls a pager in the script code, but there isn't a pager element in the HTML:
http://demos.kendoui.com/web/listview/remote-data.html

This article mentions the "pageable" property:
http://docs.kendoui.com/getting-started/web/listview/overview
But, then the API documentation makes no mention of it:
http://docs.kendoui.com/api/web/listview

This article is about the only one that is useful (although, the JSFiddle embeds just spin trying to load and never do), and it took a little searching to find it:
http://docs.kendoui.com/howto/howto-use-the-listview-of-kendo-ui-web

Lastly, looking at ListView is the first time I encountered the "kendoPager" thingy. I call it a thingy because it isn't documented by itself anywhere that I could find, but is just a dis-jointed call available from the framework. Is it just for the ListView? Are there other somewhat undocumented thingies like this in the framework?

Please do a more thorough review of the documentation (in general). KendoUI is large and can take a lot of time away trying to find basic information for widgets and features and figure out how to use them properly.

That said, I love the framework so far, keep up the great work.

[Alexander Valchev]

Hi Joshua,

Thank you for getting in touch with us.

First of all let me clarify that the ListView widget does not have a pageable property. If the developer would like to append a pager he/she should initialize it separately. This is demonstrated in the first demo:

• http://demos.kendoui.com/web/listview/index.html
  
  

<div id="listView"></div>
<div id="pager" class="k-pager-wrap"></div>

<script>
    $(document).ready(function() {
        $("#pager").kendoPager({
            //...
        });

        $("#listView").kendoListView({
            //...
        });
    });
</script>

There is a mistake in the second demo that you pointed out. There is no element with ID pager which is why there is no pager in the sample. There should no pager in the demo, I removed the pager initialization from the script.
I have also modified the wrong overview topic. API reference is correct.
As a small sign of our appreciation for bringing this to our attention I have updated your Telerik points.

Last but not least, the Pager documentation is available here:

• http://docs.kendoui.com/api/web/pager
  
  

I hope this will help. The documentation is already updated live. Demos will be updated with the next release which is scheduled for the end of this month.

Regards,
Alexander Valchev
Telerik