move description to make docs more readable and match actual code