slightly more verbose docs