Trying to understand Riak by its documentation is like trying to understand Redis by reading up on ziplists.
Edit:
I'm the author of the two Little books mentioned above. I have no doubt that Riak's documentation can be much more approachable. (and I have a love-hate relationship with writing and would never write for money, so you can't hire me, if you were so inclined)
Your "little" series is a boon to humanity man :(
Now that I know Riak is a different NOSQL db, next time I'll spend more time reading the docs.
Thanks.
It hasn't been until two years later that I've actually found a need for it - it handles very specific pieces of our data model that grow rapidly and doesn't need to be queried or indexed in any complex manner. We still use a relational database for user records, profile records, transaction records, etc...
Moreover, if you just show someone the API for Riak and what it's capable of doing, you're not really giving them an appreciation of what Riak is about. To an application developer, Mongo's interface is probably much more congenial and full-featured.
I think there's a certain extent to which you either have the problem Riak solves and know why you'd want it, or you don't and no tutorial is going to change that. But that might just be an opportunity for a really creative tutorial.