I've just started working with Workspace and I've just done a project integrating some of our ITSM products with Slack, so I think I'm in a good position to compare.
Here's an example of the tough learning curve. I think that the first thing a new developer will try to do is send a message to a Space.
Looking at the documentation here https://workspace.ibm.com/developer/docs, there's a line near the top which says "Just click here, Sending a message, where you can experience in less than 5 minutes how to accomplish this using a simple REST API.."
I click and a section that begins :
"Watson Work Services provides a space object as context for people to interact via its conversation object by posting messages to it. When you post messages, you can provide formatting to your message and you can have additional properties added through the use of an Annotation object. We will support a variety of message annotation types. Our default type contains the message and associated items to render your message, letting you provide a look and feel to your messages. You can read the API reference here, Spaces API Reference and learn about the parameters of the Annotation."
So instead of something simple that can be done in 5 minutes, I get some very jargon dense text, which sends me on somewhere else.
There's no sample, example, or wizard tool (like the Graphql api has).
Honestly, after reading for much more than 5 minutes, I have some idea of the theory but no practical help in sending a message to a space.
How about a nice, simple, curl example?
That being said, it looks like we've starting off with a nice, rich API that we can do a lot of interesting things with - looking forward to it!
Please sign in to leave a comment.