Tidy up UBI docs

[epugh]

UBI has evolved since we first launched the plugin. The spec is 1.2, we have an actual JS client.

Need to review the docs, based on feedback from users, and improve them.

[jzonthemtn]

Is this task still outstanding or can it be closed?