some docs, and tests boilerplate