Include working examples / screen shots of UI components in Kendo UI documentation

6 posts, 0 answers
  1. Keith
    Keith avatar
    22 posts
    Member since:
    Sep 2010

    Posted 26 Feb 2013 Link to this post

    The Kendo UI documentation is pretty good but providing working code / screenshots of the various UI components would be a big help. I understand that users can override all of the visible attributes of a component via CSS but at least showing the default look and feel would be helpful to developers just starting out with Icenium. I have found myself creating a KendoPlayground app just to create samples of all of the button, listview, etc... features so that I can see what they actually look like. I know that you have some of this functionality demonstrated on the "Kendo UI Demos" but it would be extremely helpful to have this info right on the documentation pages.

    For example, the current Kendo UI Mobile "Button" API Reference page only displays the javascript features and you have to go to the associated Getting Started page to see the markup for this component. However, neither of these pages actually show what a button looks like on any of the supported platforms. Also, there is mention of icons usage on the Getting Started page but I have yet to find any mention in these docs about usage of the "km-icon" class or any of the other associated classes that can help a user to control and style the button component.

    Kendo UI and the associated MVVM framework is great but I feel that the documentation is lacking for even experienced developers that are new to the framework.
  2. Kamen Bundev
    Admin
    Kamen Bundev avatar
    1532 posts

    Posted 28 Feb 2013 Link to this post

    Hi Keith,

    Thank you for this suggestion. We are definitely looking for ways to improve our documentation and we were already thinking of adding some screenshots or live examples where appropriate. Additionally every page will have quick links to related other pages - for instance API pages to the respective Getting Started ones and vice versa.

    Icons are covered by a special Getting Started page, you can check it out to see if there's enough information there. You don't usually need to specify the icon classes by hand - you only need to set data-icon="[icon_name]" on your button and an icon will be placed in it. Same goes for TabStrip buttons, ListView items and Detail Buttons.

    All the best,
    Kamen Bundev
    the Telerik team

    Share feedback and vote for features on our Feedback Portal.
    Want some Kendo UI online training - head over to Pluralsight.
  3. Keith
    Keith avatar
    22 posts
    Member since:
    Sep 2010

    Posted 28 Feb 2013 Link to this post

    Thanks Kamen. I saw the link on how to use icons and it was somewhat helpful. I think one of the key items missing throughout all of the documentation is clear definition on which "data-***" attributes can be applied to which HTML elements as well as clear definition on how these "data-***" attributes work. I understand now that the API properties / events can be mapped into the "data-***" attributes but it was definitely not obvious when I started. Also, it is still not clear to me what goes on behind the scenes with each of these attributes. This information would be especially useful to those developers attempting to leverage a different MVC / MVVM framework (i.e. AngularJS, KnockoutJS, etc...).

    Again, your team has created an awesome framework and I can't believe how well my apps run on real devices. The performance of Kendo Mobile on Android devices is incredible. It is hard to distinguish the app from a true native app. You definitely have a leg up on your competition. I have tried around 10 - 15 other app frameworks and most have run well on IOS but Kendo Mobile is the first framework I have found that runs just as well on Android. Keep up the great work!
  4. Kamen Bundev
    Admin
    Kamen Bundev avatar
    1532 posts

    Posted 04 Mar 2013 Link to this post

    Hello Keith,

    Thank you for the kind words. Unfortunately there are some areas in which we still got problems on Android due to bizarre browser bugs - if you plan to have data entry, please check the Forms article in our documentation.

    About the data attribute - there is in fact a separate article about data attribute initialization - check it out here.

    All the best,
    Kamen Bundev
    the Telerik team

    Share feedback and vote for features on our Feedback Portal.
    Want some Kendo UI online training - head over to Pluralsight.
  5. David
    David avatar
    1 posts
    Member since:
    Feb 2014

    Posted 12 Feb 2014 in reply to Kamen Bundev Link to this post

    Where can I find a list of apps in the app stores built with Kendo and running on both Android and iOS? 
    Thanks for your help. 
    David Kris
  6. Steve
    Admin
    Steve avatar
    10941 posts

    Posted 14 Feb 2014 Link to this post

    Hi David,

    There is no such list neither in App stores, nor on our end. Most users are reluctant to share such information due to privacy concerns. Still if some users have not changed the default Application Identifier of their app and have published it to an App Store, you would be able to search by the default App ID.

    Clearly a professional app has most likely changed that default App ID to a proper App ID corresponding to the company/author, so you would not see those in this search.

    Regards,
    Steve
    Telerik
    Icenium is now Telerik AppBuilder, and is part of the Telerik Platform. For more information on the new name, and to learn more about the Platform, register for the free online keynote and webinar on Wednesday, February 12, 2014 at 11:00 a.m. ET (8:00 a.m. PT)
Back to Top