Fleshed out Refer API/JsDoc

Now clearer how it will work once the subscription/notify changes are made
later.