wvonhagen

In addition to filing bugs, I'd love to get suggestions about how we could improve the documentation. Did you find the API reference material lacking, was the problem in the procedural documentation, (or was it both)? Is the problem with our service docs or figuring out Bluemix? As @jsstylos pointed out, the forum is the way to let us know what you think - not just bugs, but thoughts on what's missing and how to improve things. We'd really like you to be successful ;-)

Since the sample Watson code is downloadable and intended to show how to use these services, I find it odd that you cite "over commenting" as a problem. Comments are a great thing in sample code, especially in code that you can download separately, without docs.