That was my experience as well. An underdocumented mess.
Can you tell us about any of the problems you experienced?
I just remember it was a nightmare to get it working in both chrome and firefox, the tutorials were outdated, the official docs at w3.org were wrong (suggested settings would break the app), error handling was not consistent, lots of race conditions, API was too complex and awkward, etc.
Try shane tully's example code. Its simple and works well.