Please take a look at http://staging.aerogear.org/docs/specs/aerogear-js/ and let me know if you would like anything else updated, keeping in mind that we are working on https://docs.google.com/document/d/17J-qFm_Fr0rsgusgjcwGhXFOnd2369KZgOYP9kkwOlQ/edit
Thanks!