document the new property, correct Usage, remove todo