Oh, where is the 'Documentation' link on the site?
I tried to convince some of my friends about using QCubed. They asked me the website link. I gave them. The first question: where is the documentation. The second - "How do I install it on Windows?" The third one - "Why are the tutorials outdated? And why the hell there are 'PDF' tutorials?"
And the Final question which anyone would ask himself before choosing QCubed is: "With the number of frameworks out there, why should I choose QCubed?". The sentence you just read is a bit awkward and incorrect by grammar but a really correct one psychologically. I know because I have had the same question and I see everyone having it.
The success or failure of any business / project / organization depends on how well it answers the questions thrown at it. A REALLY BIG point where QCubed is failing is the 'Documentation'. I know that the examples serve a great deal of help for the users of QCubed, as well as those who want to start with. But it does not serve for the 'Documentation'. If one were to ask the various parameters a Datagrid takes in, what all they are, what they mean, what are the alternatives, format, datatypes of the arguments and how they can modify behavior using the API (without actually changing the core framework code), what would you answer?
There are a whole lot of other things which I believe cannot be solved by the examples site. A documentation part is required. QCubed seems to be ignoring that part. This leads to lot of people going away from the framework just becuase they do not know where to begin!! Let me tell it: the 'Tutorials' and 'Examples' are NOT working out for you. You are losing users and thus potential contributors. You are slowing down the pace of development in the long run.
I have tried talking about this in other threads but I think that this is something that must be discussed in its own thread. As far as I see, the site, as well as the forum is using Drupal (I have used Drupal 6 and it feels like this is one of them). If it is so, why don't we use the 'Book' content to document things? not only it allows you to create the documentation but also manage comments on each single topic. New changes in versions can be made in form of 'Revisions' which drupal supports as well. Would it not be great in those regards? I simply want this f/w to be on the top. That is all.
In case you have felt anything offensive, it was not intentional. All I say is because I like QC as much as everyone else here does.
Regards,
Vaibhav
