Try Now
More in this section

Forums / Suggestions / Lack of documentation

Lack of documentation

2 posts, 0 answered
  1. Viktor
    Viktor avatar
    22 posts
    01 Nov 2011
    06 Dec 2011
    Link to this post

    I count myself to be a competent developer and I have been using sitefinity for the past few weeks.

    I'm disappointed with a lack of documentation, blogs and good description of sitefinity architecture. I have also came across obsolete API, without clear guidance on what it should be replaced with.

    The majority of articles simply say take this code and paste it here. Quite a lot of types in the copied code don't get implemented until next article, which makes it very difficult to work with, as I don't know what is happening and why the code is structured in this way. For example, types referenced here http://www.sitefinity.com/40/help/developers-guide/how-to-how-to-create-a-jobs-module-implementing-the-provider-pattern-creating-the-manager.html get created only in the following article - http://www.sitefinity.com/40/help/developers-guide/how-to-how-to-create-a-jobs-module-implementing-the-provider-pattern-creating-the-configuration-class.html 

    By copying and pasting code I'm not learning anything.

    I feel that documentation is very much behind and I would rather see a much more complete documentation and more blogs, articles, discussions rather than new features.

    There are also quite a lot of classes, methods with pointless documentation. E.g. PageNode and PageData class. Comments in the PageData simply say "Stores page data". I could have worked this out, but more importantly, documentation doesn't explain a purpose on why we need this class and how it should be used. Yes, I can work this out by spending time online, going through blogs and debugging the app, but I don't expect an enterprise level solution to have these problems.

    Don't get me wrong, it appears to be a great product, but things that I have mentioned above are making it difficult to work with.

    Can you please let us know whether you plan on addressing this in near future, and whether you see this being an issue for developers.

    Apart fromt this, the product and support are great and I look forward to future releases :)

    Thank you
  2. Lubomir Velkov
    Lubomir Velkov avatar
    688 posts
    03 Nov 2014
    09 Dec 2011
    Link to this post
    Hello Viktor,

    Thank for your insightful considerations. We are constantly working on improving the documentation and the samples for our product. We plan to release a new batch of documentation after the upcoming 4.4 release.

    Best wishes,
    Lubomir Velkov
    the Telerik team
    Do you want to have your say in the Sitefinity development roadmap? Do you want to know when a feature you requested is added or when a bug fixed? Explore the Telerik Public Issue Tracking system and vote to affect the priority of the items
2 posts, 0 answered