fix docs + tests + add .require() to definition