adding documentation for pairs.