Neil, please don't tell me that you think the PowerStore is sufficient all by itself without anyone making any changes. Of the four bullet points promoting the PowerStore one says:
"PowerStore was built with a wide variety of our Dreamweaver plug-ins and therefore can be modified, customized, and extended with these plug-ins."
If for no other reason than to facilitate your own development efforts it should be documented. Nor is PowerStore unique. NONE of your code is sufficiently documented. It's not hard and well worth the money to build a tool which produces a per cent documentation number for any source code.
Even if NO customization were done, there is no information about the database and how it was intended to be used. As an example: In the products table a field is named "ProductUnlimited." What do you suppose I as a powerstore user should put in that field. True/false meaning sell without limit? I don't know and how is it going to be used by the code. I don't know. How about a field called "ProductLive." Is that True/false for pigs and goats. Who knows?
I'm being hard on you but for good reason. I like WebAssist and I only wish to tell you what I perceive as ways to make you better. The path to improvement must first include acceptance. You can't make constant quality improvement until you accept that you need to improve. Your statement "We are working hard towards improving documentation for all of our products." Is very positive. But deflecting criticism of PowerStore is very negative.
What happens to these comments. Do any product managers ever read them? Do you ever take them to Ray and have him read them? Be an agent of change.
While you say that it isn't your primary focus to document code, I would hazard a guess that the same worst practices that produced your nearly comment-less code continue as standard practice today on new code going forward. In my opinion, and I'm not without experience to make my opinion valid, the single biggest contribution to poor code is lack of documentation.
Thanks Neil, I hope you don't take this personally. I'm just trying to help.