add docs for registration api. fixes #7