finish the lib-ification
docs are awesome