In my last conversation over the phone, trying to set up the tools to work with Bluemix, several "Getting Started" pages for important steps lead to 404 errors.
For a Watson-specific example, at least a few months ago it was the case that putting together a full-featured client implementation for Q&A required poking around several obscure webpages and then plenty of runtime experimentation on top.
1) Decouple your examples from Bluemix. It's needlessly complicating your efforts to get people using the APIs which is why people are showing up, not because they want a PAAS. At least not right off the bat. Less moving parts = better.
2) Create GOOD examples/API libraries for all the languages you're creating these examples for. The ruby on rails example is lacking. It doesn't demonstrate how to call the APIs at all. I'm using the REST API docs and the only headway I've made there is that I'm able to authenticate and create a session. Trying to upload audio using your documented approach (passing the session id as a path param) returns a 401. Passing the u/p via BasicAuth in the same request doesn't work either. As of right now I have no idea how to get an audio post to work and very little in the way of debugging information/docs.
I did get things working and am working on a ruby gem that I'm hoping to be able to release for general consumption but in the mean time for folks using ruby here's a snippet that will get the simple case working once you've setup a bluemix app and bound the speech to text service to it:
We tried using the "tradeoff Analytics" service for the project - and I must say , the tools and help available around it, the API and its documentation is pretty bad , convoluted and unusable. This is true too other services available through watson too.
We looked into IoT ( Internet of things ) as well . And once again , ran into a ton of dead ends without being able to proceed. The API documentation and examples just suck . If you are used to playing around with well documented APIs / Tools / Languages - this is going to be frustrating.
If the OP is the person who actually wrote the article , please please please go back to Watson Dev Cloud or BlueMix and try it out your services and APIs an a consumer.