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 :)