addressing feedback/updated description

#1903

is this correct?