registration, better api flow, doc update