expand return possibility and flesh out docs