add some arities and docs