Rich,
The new documentation isn't complete yet, but it's much better. The main sections missing are the Action creation in JFBConnect and the different ways to 'use' the actions on the front-end. That should be done later tonight or tomorrow though.
If you start reading through it, we'd love your feedback.
Thanks,
Alex