cleans up description

capitalization, adds ref to pair type.