add basic documentation of js-api; will update it as we move along