minor updates, documentation update in apiary